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IMkOOUCT  lOh 


Design  tec*mi.Tues  for  user-oriented  graonics  softv»are 
systems  are  investigated.  The  nrincicles  and  technicues 

4 

gained  from  this  research  have  neen  aoolied  in  the  implemen- 
tation of  such  a system  fpr  a Ri"'T£K  Gx-lOC^  oisolay  device. 

Primary  emohasis  is  olaced  on  orovining  a user  with  the 
prooerly  constructed  software  suroort  and  accompanying  docu- 
mentation for  efficient  utilization  of  the  grachics  display 
system.  The  technioues  and  decisions  involved  in  performing 
such  a design  are  discussed  in  detail. 

Additional lv»  the  vector  General  Tablet  was  interfaced 
with  the  support  3vst‘=‘m.  This  interface  provided  the  user 
with  an  external  interactive  device  for  control  of  the 
graphics  system..  The  ability  to  interact  with  the  system 
greatly  enhanced  the  desirability  of  the  over-all  oesicn. 

The  basic  sfecs  in  the  application  onase  «ere  to  choose 
a lanauage»  desion  systems  functions/  write  a detailed 
user's  manual/  and  implement  and  t®st  the  system.  The  user's 
manual  (Apnenoiv  A)  orpviaes  even  the  inexperienced  program- 
mer with  a tool  for  rapid  access  ♦'o  the  system.  It  is  com- 
plemented with  a tutorial  se*’  ot  examples  that  more  accom- 
plished users  mioht  proceed  to  immediately. 
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The  desioned  system  wes  imr5?ememted  in  the  C orcgram- 
ming  lanauage  and  hosted  Ov  a POP-l'/SO  comcuten  in  the 
Naval  Postgraduate  School  Computer  Lacoratory. 
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The  following  is  a Quote  froni  Dr,  Eric  Carlson  of  tne 
IBM  Research  Division  fl^l: 

"In  the  oast/  oroaress  in  terminal  hardware  technolocy 
ana  araohics  software  rechniques  has  net  ceen  accor'- 
paniea  bv  similar  oroaress  in  uncerstanainq  t^e 
reQuirements  of  the  user  and  aoplications  of  co'^cuter 
graphics". 

The  desinn  effort/  therefore/  in  computer  araphics  must  be 
apolie  orovide  clarity  in  man/machine  communication. 

evolutionary  crocess  of  a user-oriented  system  must 
begin  with  a firm  definition  of  the  user,  [n  this  context  a 
user  is  defined  to  be  some  person  or  arc up  of  persons  who 
desire  to  utilize  some  graphics  system,  me/  for  the  most 
part/  is  a non-comouter  scientist  who  simply  wishes  to  be 
assisted  Ov  the  computer  in  the  solution  of  some  pronlem.  If 
he  must  exoend  a great  dea'  of  effort  to  learn  how  to  use 
the  system  oeforp  any  benefits  can  be  accrued/  then  the  sys- 
tem appears  not  to  ne  a tool  out  Just,  another  hurdle. 

Any  comouter  System  nas  the  ultimate  curoose  of  solving 
a problem  or  set  of  croclems.  in  hen  a user  elects  to  utilize 
the  Power  of  a comeufer  system  to  solve  a oroblem,  then  un<- 
nowingly  he  or  sre  has  anded  the  reauiremont  that  the  croo- 
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1 eTi  be  statea  in  two  very  nistincr  ways.  The  rmoblem  must  on 
one  hand  ta<e  on  a structure  that  is  amenaole  to  tne  corn- 
outer/  and  on  the  other  hand  be  stated  clearly  and  concisely 
to  man.  As  the  user's  statement  ot  the  oroolem  is  decomoosea 
to  a mac  h i ne"0  r i en  t en  statement-  of  the  same  oroblem,  the 
interface  o®tween  the  user  and  the  syste'"  is  critical.  The 
ideal  interface  croviaes  a conservational  communication  or 
"symniosis"  Oet«een  man  and  machine. 

The  user  myst  ce  nroviaea  as  m. ^ny  aids  as  onysically 
Dossiole  to  create  an  atmosohore  that  is  conducive  to 
creative  thouant.  If  he  expends  fre  ma.iority  of  his  effort 
attempt i no  to  commuricate»  he  is  not  likely  to  be  very 
creative.  Ihi.js  the  man-macrine  communication  must  he 
enhanced  in  every  conceivaole  manner. 

The  desian  effort  must>  necessarily,  ceain  with  con- 
siderations of  availacle  ecuicment.  It  tne  eouioment  is 
already  in  oosition,  as  it  was  in  this  endeavor,  tre 
designer  srculd  strive  to  interface  appropriate  interactive 
tools  for  a oleasant  communication  scheme.  These  devices, 
thoudh  Quite  varied^  "can  oe  treated  as  a physical  realiza- 
tion of  one  of  four  virtual  devices  : th°  oick,  the  button, 

the  locator,  ang  tre  valuator"  II^J.  The  four  virtual  dev- 
ices are  defined  below: 

A,  A oic<  is  used  i-p  designate  certain  objects.  The  us“r 
will  often  neec  to  ocint  at  ohjectSf  just  as  a person 
may  point  his  *imonr  to  denoha  a particular  place  or 
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b.  A button  is  ^ or  oroarammi^tic  control  --  Sucn  as 
selectinq  a oarticular  action  froir  several  oossible 
actions,  (con^monlv  a function  kevboaro) 

C.  A locator  allows  the  user  to  locate  soecific  coints 
within  his  oefineO  inaqe  soace.  (contronly  a tablets 
joystick#  or  ircuse) 

0.  A valuator  nrcvioes  t"e  caoaDilitv  to  oetermine  a 
oarticular  value  fron  so^ie  o<=fineo  real  space. 

Fnus  in  oesiqnino  a user-oriented  system,  certain 
hardware  selections/interface  Cecisions  nust  ne  performed 
prior  to  emDar<inq  on  the  software  support-  oesiqn. 


The  aesiop  of  a u se r -o r i en t eo  graorics  software  system 
must  Provide  the  full  capability  of  tre  oracnics  device# 
satisfy  the  user#  and  not  overload  tne  -ost  computer.  To 
achieve  these  deals#  a toe  dCwn  accroacn  seems  most 
appropriate  while  maintaining  a constant  focus  on  user 
reauirements.  To  realise  a successful  design  of  a graphics 
software  syste"--  tne  designer  must  cnoose  a suitable  imple- 
mentation lanouaoe#  crovije  aOenuate  software  support  func- 
tions# oevelop  oetaiied  documentation#  and  finally  implement 
tne  desion  and  perform  detailed  testing  of  the  package. 

The  authorities  on  computer  araonics  tooay  see  two 
feasible  choices  for  graphic  language  selection.  A graphics 
lanqu aae  mav  re  developed  for  the  specific  device  or  an 
existing  hinr-level  languaoe#  supclempnteg  f-y  3 library  of 
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suDroutineSf  T'av  be  eir’oloyed 


The  desianer  elect’s  to  crcvioe  a sceciai  oucoose  » 
device  aeoendent  lanouaae  is  nofnallv  dioectinc  nis  atten- 
tions to  a sutiset  o^  top  entire  user  ccou'ation.  Suct>  a 
1 anquaae  will  otten  gnolov  oeculiar  constructs  -rile  striv- 
ing for  increased  effiencv.  Tn  orevious  studies  it  ras  been 
found  that  the  design  am  imrileTentation  o''  a special  pur- 
oose  araohics  ' arcuaoe  often  provides  -mro  of  a learning 
experience  to  toe  desio nop  than  a useful  tool  to  the  user. 
In  addition,  tre  oeveloment  of  such  a language  invariaply 
reauires  a oreat  deal  of  expertise  in  lanouage  c'ructures 
and  often  snowballs  into  a costly  and  tirre  consupinq 
endeavor. 


The  >rost  cotnon  approach  to  utilizing  graphics  eouic- 
dient  is  to  ouild  aroum  an  existing  lanouage  and  generate 
Cl^LLS  to  3 set  of  subroutines  resident  in  so'^e  library.  Tre 
host  languaoe  tust  croviie  the  necessary  faci'ities  / sup- 
port the  appropriate  data  structures#  and  possess  an  effi- 
cient subroutine  call  capability.  If  such  a lanauaoe  exists 
in  the  design  environment,  strono  considerahicn  snoulo  be 
given  to  efrcloyina  it  as  the  case  lanouage  for  the  oraphics 
s y s t eip  . 

havino  considered  all  notions  and  selected  a base 
I anguaoe  upon  which  to  nuild  the  orachics  syster",  the  focal 
ooint  of  the  oesion  process  most  n®  shifted  to  the  logical 
formulation  of  the  grernica'  primitives  reauirea  bv  tre  user 
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Dopulation.  1 1 i a'^'  . ■sle^'^an  and  Robert  F.  Sproull  [10] 
profess  ttiat  "the  only  araphicat  primitives  that  the  pro- 
qrammer  needs  are  functions  to  define  ooints»  lines  and 
display  text  shrinas".  These  basic  primitives  certainly  pro- 
vide the  most  fpnaamental  set  of  tcolsf  but  by  offering 
selected  options  to  the  user  a less  hostile  and  more  flexi- 
ble system  may  evolve. 

The  founoation,  naviro  oeen  envisioned  ano  loaically 
desiqneo/  shoulOf  wn^n  plausicle»  be  expanded  to  provide  the 
user  v«ith  a powerful  set  of  rioh-level  tools.  The  direction 
of  this  expansion  is  necessarily  precipitated  ov  the  purpose 
for  the  arachics  system.  Tnis  process  may  provide  a very 
precise  set  of  functions  in  the  design  of  special  purpose 
systems/  or  a number  of  task  oriented  functions  which 
emphasize  overall  system  oenerality.  Each  new  function 
spawned  by  this  expansion  must  provide  the  user  with  a new 
and  Powerful/  yet  simple/  tool. 

Documentation  must  oarallel  the  entire  oesian  process. 
A vitally  important  oart  of  tnis  dccumeotation  effort  is  the 
creation  of  a detailed  user's  manual.  This  user's  manual 
should  be  virtually  complete  prior  to  the  implementation  and 
test! no  Phase.  The  desianers  have  thus  stated  rpw  tne  ulti- 
mate system  is  envisioned. 

htavina  reachel  this  plateau  / tre  implementation  ano 
testing  phase  nedins;  nut  th<»  documeni-aticn  effort  must  con- 
tinue in  oarallj>l.  Tn  the  pod/  the  complete  set  of 


aoc  urren  t a t i on  efforts  must  inclurie  a oetailen  user's  n-anudl^ 
documenteo  source  ccde»  synopses  of  functions/  and  a trace 
of  tne  entire  orocess. 

The  imole mentation  and  testing  phase  oeains  with  ti^e 
creation  of  the  actual  software  to  perform  the  orocosed 
actions.  As  this  software  comes  into  ceino»  detailed  testing 
must  oe  performed  to  ensure  that  it  functions  as  envisioned. 

In  summary.  the  designers  must  follow  some  pro- 
estaPlished  plan  for  the  deyelcc^ent  of  a graphics  software 
system.  In  the  aosence  of  sucr  a plan,  it  is  almost  inevit- 
able  that  the  resulting  system  will  fall  snort  of  its  expec- 


tations 


LANGUAGE  SELECTION 


III. 


As  oreviously  state tnere  are  two  clausible  choices  in 
selecting  the  lanauace  to  suooort  a user-orienteo  graphics 
system.  This  choice  is  driven  by  the  ultimate  purpose  of  the 
system^  time»  ana  money.  Ine  system  cesigners  may  deyolop  a 
new  1 anquaae  tailorea  exclusively  for  the  aevice^  or  utilise 
an  existing  hioh  level  lannuage  augmentec  cy  a library  of 
functions  for  control  of  the  device.  heqaroless  of  the 
course  of  action  the  selection  snould  "crovige  a languaoe 
which  is  natural,  and  whicr  does  not  add  to  the  boredom, 
panic,  frustration,  and  confusion  of  the  user"[lcl. 

The  environment  for  tne  aasign  effort  asscoiatea  with 
this  work  was  for  the  most  nart  acaoemic  ana  reouirea  great 
flexibility  ana  aeneraHty  *or  t"e  widely  variea  user  copu- 
lation. The  users  of  the  projected  system  would  come  from 
all  bacxorounos  and  with  an  infinite  set  of  reauirements  for 

I the  svstem.  G,t.je  to  this  need  for  extreme  flexibility  a 

search  began  to  find  a suitable  high  level  lanquage  to  meet 

the  r»au i rement s . 

i 

The  possibility  of  constructing  a uniaue  lanquaae  to 
Support  the  system  was  ruled  out  almost  immediately  due  to 
the  time  constraint  of  the  e^forh.  Lack  of  time  was  cer- 
tainly a valid  reason  in  itself,  but  other  factors  also 
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dee  me  a this  course  ot  action  unfeasible.  The  goal  /^as  flexi- 
bility^  and  alrrost  always  a new  language  Decor'es  directea 
to  a subset  of  the  user  oooulation.  Tne  aevelooed  system 
would  reauire  on  station  software  maintenance  and  would 
receive  little  or  no  attention  if  it  existed  as  a new  and 
foreign  language. 

Having  maae  the  basic  choice  to  utilize  an  existing 
hign  level  languaoe  the  searcn  oeoan  for  an  acceptable  one. 
The  ''iaval  Postoraduate  Scnool  Comouter  Laooratorv  hosts  tne 
eouioment  and  as  sucn  its  caoaniHties  ana  restrictions  were 
considered  in  detail.  There  were  several  1 anouaoes  commonly 
in  use  wit'hin  the  confines  of  tne  laooratcry  (C/  rortran, 
Basic). Ihe  most  widely  used  of  all  the  lanouages  was  C 13] 
and  as  such  research  was  initiated  to  ascertain  the  feasi- 
bility of  this  choice  for  the  urooosea  system. 

The  C crogramming  languace  was  well  documented  and 
allowed  the  user  to  write  clear  am  concise  or og rams.  It  hag 
nice  control  caoaoilities  ra< i nn  it  a very  readable 
languaae^  and  it  allowed  the  user  to  write  code  thst  is  verv 
comoact  out  still  c'ear.  Tne  language  encouraged  a modular 
desian  and  orovided  all  of  the  necessary  constructs  to 
imolement  a vianle  graonics  system.  The  fact  that  the 
lanquaue  was  commonly  used  ov  oersonne'  involved  in  research 
within  the  confines  of  the  laboratory  was  another  olus  for 
selecting  it  for  this  aDolication.  The  feelino  was  that  tne 
C orograrnmim  lanouane  would  suboort  a comoletely  flexible 


and  general  nurnose  gr^onics  svste"^/  thus  the  decision  to 
imolement  the  svste'r  with  it  as  the  oase  d r og  r a.Tin  i n g 
language  was  rraoe. 

A sottwara  supoort  package  existed  for  the  RAMTEK  11^] 
at  the  onset  of  this  research  effort/  Out  its  configuration 
was  unacceptable  oasec  on  the  research  to  this  point.  From 
previous  studies  it  was  learned  that  a high  level  1 anguaoe 
Supported  Ov  a 1 ibrary  of  functions  was  tre  most  common 
approach  to  utilizing  a graphics  device.  Toe  existing 
software  support  oacoae  did  not  resemble  this  basic  design 
philosophy/  as  it  existed  as  two  very  large  blocks  of  object 
code.  Reoargless  of  th“  size  or  needs  of  the  user  program 
these  two  bloc<s  of  code  were  merely  acoendeo  to  the  com- 
piled program  resulting  in  a very  large  execution  mooule. 
This  implementation  tecnnioue  was  found  to  be  completely 
un  sa  t i s f ac  t o r V from  a design  stanopoint:. 

Having  decided  to  use  rho  C programming  language  and 
realizing  rhar  the  existing  software  support's  organization 
was  not  in  comoliance  with  the  orescrined  goa's/  tne  next 
step  uas  to  develop  the  structure  and  organization  of  a set 
of  liprary  support  functions  to  orcviae  for  specific  support 
of  tne  device.  A aetailec  analysis  of  tne  existing  system 
was  inici'ated.  Toe  system  was  ♦ounn  to  provide  the  basic 
capabilities  ang  modular  design  that  was  felt  would  be 
reduir®g.  Tre  decision  was  made  to  oase  th»  new  suoocrt  sys- 
tem on  the  C prodram"'in(3  1 annua  O'*  plus  a library  of  rudimen- 
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tary  functions  secureo  fpo"^  fn®  crevious  software  suDoort 
system. 

Prior  to  emo3r<in-3  on  the  task  of  ouilaino  such  a 
library^  the  ooeratinc  system  constraints  were  invesi- 
gated  to  reveal  the  orooer  Horary  structure.  This  environ- 
mentally imoosed  structure  «as  a major  concern  as  tne 
develooment  orrcess  cegan.  T^'e  reason  tnat  no  orevious 
attemots  nad  been  mane  to  orovine  tre  envisioned  structure 
was  that  it  was  to  oe  ouite  teoious  ana  oossioly  reauire  a 
great  deal  of  renesicn.  in  tne  UiyIX  en  v i r on'T'en  t the  library 
is  searched  seauentially  from  start  tc  finish  to  resolve  any 
undefined  references  from  the  comcilation  of  a user  program. 

This  linear  searcn  oroceoure  employed  cy  the  host  sys- 
tem dictates  that  the  Horary  have  a very  precise  structure 
if  it  is  to  oe  efficient,  “^s  the  Horary  search  is  perform. ea 
all  references  oy  internal  functions  must  ne  forward  to  cir- 
cumvent the  necessity  of  muHiole  searches  of  the  same 
library.  ^ailuro  to  orpanize  the  library  arouno  this  very 
real  constraint  coulo  result  in  very  inefficient  utiliza- 
tion. To  organize  the  rudimentary  Horary  in  such  a way 
reauired  inoeotn  study  of  tne  existinq  software. 
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istinq  software  suoccrt  oacode 
deter-ine,  withnur  “xceotion, 
each  mcrtule.  It  was  caramount  to 
of  function  calls  ■fro""  each  of 
. Tnis  information 
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cedural  functions 
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found  to  be  best 


deoictea  in  tabular  for-nat 


A taole  of  cross-references  for  each  function  was  con- 
structea.  Tris  taole  ultimately  aisolavea  the  calling 
sequence  for  each  function  ana  what  functions  calleo  it. 
This  organ i zat i ona 1 steo  orovineg  the  insight  reauired  to 
beoin  to  organize  the  liorarv.  bad  the  original  oesign 
emoloyed  a library  in  the  1 anguaoe  decision  orocess  vice  two 
large  "proorams"  this  steo  coulg  have  oeen  eliminateo  from 
this  aesign.  The  fact  that  the  new  use r-o r i en t ed  aesicn  will 
be  in  a Horary  will  facilitate  Tiore  efficient  software 
maintenance  ana  s i on i f i c an t 1 y reduce  the  size  of  the  user's 
execution  module. 

The  existino  oacxage  was  written  in  the  C orogramminq 
language  and,  as  suer,  fitted  the  oroocsed  1 anguage  imcle- 
mentation  fechniaue  cuite  well.  Thp  structure  havirig  oeen 
exposed/  the  tas><  was  to  build  a fundamental  support  library 
from  previously  nevelcoed  software.  Tne  functions  were 
further  researched  to  see<  out  wnich  variacles  were  used  by 
each  function.  Tnis  process  was  most  involv»a»  out  neces- 
sary, as  the  environment  of  aHowee  for  only  singular 
initialization  gf  each  variable. 

An  ordanizational  chart  was  Tevelored  to  ascertain 
where  ana  when  initialization  ot  eacn  variaole  was  to  tai^e 
place.  Once  tno  variables  naa  been  lain  out  in  a logical 
initialization  senuence»  '■‘■e  actual  buildinp  process  could 
be  embarieed  uoor.  The  conc^otual  design  could  re  seen  as  a 

1 ® 


feasible  tasic 


> but  an  exdicit  layout  of  t*ie  orobosed 
library  haci  to  be  niaae  ana  rranuallv  verified.  The  struct  ure^ 
to  be  efficient.  Had  to  oossess  no  backward  references  ana 
oroviae  for  singular  initial i^ation  of  all  variables. 


The  base  library  ^vas  desionea  and  i (rc  1 er-en  t eo . After 
detailed  testina  it  became  apoarent  that  the  new  concect 
performed  oetter  than  the  old  even  trough  there  were  no  phy- 
sical improvements  to  the  software  functions  themselves.  The 
library  provided  much  smaller  execution  modules,  as  only  the 
user-requested  functions  were  appended,  not  the  entire  pack- 
age as  was  previouslv  the  case.  This  newly  stnuctured 
liorarv  also  possessed  the  benefit  of  ease  of  maintenance 
and  expansion.  This  represented  a major  step  in  the  overall 
goal  of  the  project. 


The  first  steo  in  the  design  of  a use r -c r i en t ed  oraph- 
ics  system  had  been  accomplished.  An  existing  language  sup- 
ported pv  a Horary  of  subroutines  had  been  chosen  for 
implementation  of  the  system,  had  this  step  been  performed 
in  the  original  investigation  a more  viable  and  maintainable 
system  would  have  existed  from  which  to  oecart.  It  was  felt 
that  this  structure  provided  maximum  flexibility,  efficiency 
and  created  a firm  case  from  which  to  proceed  toward  a 


user-oriented  svstem. 


IV 


OESIGM  OF  SYSrt'-’  FUMCT1U,\3 


« 


Tne  trena  in  tne  ne v e 1 00^90 t of  graohics  software  sys- 
tems is  towang  high-level  software  suocort  cac'caaes  that 
DPOviae  siTole»  oowerful  controls  over  the  cacaoilities  of 
the  system,  yet  shelter  the  orograrrm er  from  t''e  low-level 
features  of  the  hardware.  Ire  desion  of  the  functions  that 
make  UP  these  software  cackaoes  nlays  a vital  cart  in  deter- 
mining the  success  or  failure  of  the  svstem  as  a whole. 

In  the  environment  discussed  here,  the  oasic  machine- 
level  interface  (the  "driver")  oetween  the  host  computer  and 
the  graohics  oisolav  device  had  oeen  installed.  In  addition, 
a numoer  of  software  routines  had  oeen  written  for  the  svs- 
tem. There  was  no  orcanizec  liOrary  of  system  functions. 
Instead,  all  of  the  written  routines  had  been  conglomerated 
into  two  files,  inclucina  a very  larce  samole  program.  Tne 
reouirement  to  nring  ootn  of  tnese  laroe  files  into  memory 
for  every  program's  execution  was  corsiderpg  unacceptable  cv 
estaolisheo  design  standards. 

It  was  decided  at  this  point  that  tne  most  realistic 
approach  would  oe  to  mocularize  t^e  existing  functions, 
organize  tnem  into  a procerlv  formatted  library  structure, 
and  thoroughly  analyze  this  oackaoe  for  content  ano  fvi no- 
tional caoanilitv.  Tne  desion  and  development  of  this  svstem 

£i0 


library  was  oiscusseo  in  "LANGU<iGE  SELECTIOri". 

The  ensuing  analysis  of  existina  routines  revealeci  ^riany 
shortcotr.  ings  that  reauireo  either  certifications  to  the 
existing  coae  or  a ccnolete  redesign  of  that  carticular 
function.  In  anoition,  the  software  oacxaqe  as  a whole  oirt 
not  offer  tne  user  the  full  capabilities  of  the  system  as 
envisioneo  by  the  oesioners.  As  i.ell  as  not  providing  the 
full  capaoility  of  the  oevice/  the  system  was  severely  lac<- 
ing  in  interactive  tools.  The  system  rtirt  not  provioe  su^fi" 
cient  control  ano  comrrunication  facilities  for  the  user, 
t'umerous  additional  t unctions  were  designed^  created/  anc 
imclementert  for  this  curoose. 

This  Phase  of  the  design  process  was  not  a purely 
creative  exercise.  It  was  a case  of  the  cesioners  overlayino 
the  existing  software  with  a "temdate"  or  "molo"  of  tne 
system  they  envisioned/  then  moditvinq,  restructurina/  ang 
exoanoing  the  existing  oac'<aae  to  fit  this  mold.  Tne  system 
functions  that  evolved  from  this  "modified"  oesion  process 
are  presented  in  detail  in  the  user's  "anual  (Appendix  A). 

The  inclusion  of  an  increased  interactive  cacatiility 

involved  tre  locical  design  and  creation  of  avenues  to 

« 

facilitate  a more  symrioric  man-macrine  communication  sys- 
tem. The  only  external  device  availao'e  to  tre  user  was  the 
kevDoarg.  A casic  graphics  system  can  survive  with  only  this 
capability/  out  shgulc  not  on  restricteo  to  this  device  wren 
the  oossibility  for  exoansion  exists.  a concerteo  effort 


/?  1 


then  beaan  tc  Drovio"  the  user  witr  a flexicle  c Cfrmun  i c a t i on 
This  tieaium  was  fnp  vector  beoeral  Data  Tablet. 

In  develonina  tnis  interactive  tool  tc  its  fullest/  t^e 
intent  was  to  qive  tnis  one  ohvsical  oevice  tne  cacability 
to  a DO ear  as  four  virtual  Devices  (oick/  cutton,  locator, 
valuator!.  Tne  oick  ann  locator  functions  coula  ce  satisfied 
via  a tablet  ariven  cursor.  Tnis  caoabilitv  became  one  of 


the 
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values  from  witnin  tnis  soace.  Pinal  iv,  tne  tablet  cculc  be 
broken  into  user-oefi^’en  switches  tnat  could  resocno  as  Dut- 
tons or  function  switcnes  for  oroqrammatic  control. 

6y  loaically  envisionino  the  tablet  as  Discussed  above, 
it  orovideo  a nice  comolement  to  the  RAv-Ttk  keyboard.  The 
user,  now  havina  two  interactive  devices  at  his  discosal, 
would  enjoy  a more  flexiole  communication  interface  with  tne 
machine. 

A cross-sectional  view  of  the  software  sucport  cackace 
would  reveal  a structure  of  "tiered  complexity".  At  the  base 
of  this  structure  would  lie  hhe  oasic  orimitives  for  a 
qraohics  system's  ooeration.  Some  of  these  routines  are  only 
one  step  removed  from  machine  lanquaoe  instructions.  These 
primitives  form  tre  foundation  for  riaher  level  function 
development,  but  must  also  be  made  accessible  to  tre  more 
advancea  users'  nrccrams.  Tr^  noxt  l“vel  in  t^e  structure 


wouI;1  oe  co'T'orisea  mof'e  definitive  draohics  aoDlications 
functions.  '"ost  users  could  accoi’Dlish  all  treir  desired 
work  at  this  software  level,  but  it  would  likely  reauire 
numerous  and  reoetitive  calls  to  these  functions.  Th^ 
hiah“tevel  functions  that  form  the  crest  of  this  structure 
are  directly  suooorted  ov  rhe  first  two  levels.  These  are 
the  functions  that  offer  the  user  more  oowerful,  orcDlem- 
oriented  or t ions. 

This  asoect  of  three  levels  of  oraouateo  ootential  was 
aoblied  to  each  of  the  functional  areas  or  control  mooes  of 
the  RA^^TEK  ourino  this  oesion/evaluation  phase.  This  was 
also  the  aooroach  used  to  ensure  that  the  full  range  of 
color  manioulation  cac anilities  were  available  to  the  user. 
Thus  as  each  basic  hardware  cecability  was  investigated,  the 
associatec  software  to  ekoloit  that  capability  was  logically 
designed  and  conceptually  aligned  with  this  structure.  If 
the  existing  software  dig  not  conform  to  this  view  or  oia 
not  function  to  the  envisioned  specifications  for  that  par- 
ticular machine  capability,  it  was  modified  ana/or  expanded 
to  do  so . 


r esu  1 t s 


of  est  at)  1 i sh  i no  a startina  ooint:  for  qeneratinq  any  display 
hao  not  taken  into  account  certain  control  mode/con t ro 1 flag 
combinations  trat  reauire  more  tnan  one  machine-level 
instruction  to  initialize  tne  prooer  registers.  N'inor 
corrections  or  imorovements  were  maae  to  numerous  other 
functions  in  the  first  two  strata  of  the  design  structure^ 
primarily  in  the  areas  of  m;3pcinq  virtual  screen  acaresses 
to  real  screen  locations,  an n oerforming  error  checks. 

The  majority  of  no^  functions  that  were  oesigneo  and 
c reat  en  au  r i na  this  process  were  hion-level  functions  aimeo 
at  improving  over-all  system  performance.  T'orina  the  evalua- 
tion of  the  color  display  tpchnioues,  it  was  recoonized  that 
a user  could  sneng  a ore  at  oeal  of  time  in  Generating  the 
exact  colors  he  desireo  for  a particular  oisplay?  vet  he  hao 
no  way  of  saving  these  color  combinations  for  subsea uent 
use,  since  the  svstem  color  tables  are  au t oma t i c a 1 1 y ini- 
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as  an  absolute  necessity.  Thus  two  new  functions  were 
developed  : one  to  copy  the  status  of  current  color  taoles 
into  a file  in  the  user's  directory,  arp  one  to  subseqi.,ently 
restore  these  colors  nacx  into  hhe  system  tacles  after  ini- 
tialization has  ta<en  place. 
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Another  ceoability  that  xas  found  lacking#  ana  was 
therefore  generated  during  tris  onase#  was  tne  aoilitv  to 
sioultaneouslv  display  frulticle  alcranuoeric  character 
strings#  such  as  blocks  of  text.  This  function  relieves  toe 
user  of  the  distracting  task  of  nna.<inq  repeated  calls  to  the 
mid“level  single  strino  disolav  function. 

tiv  application  area#  the  largest  number  of  newlv- 
introduced  facilities  were  in  tne  realn  of  rroviding  an 
interactive  capability  between  the  display  system-  and 
a Vector  General  Tablet.  ApDroximately  fifteen  functions 
were  designed  in  the  afcre-rrentioned  tiereo  structure  to 
offer  the  user  a .wipe  variety  of  interactive  technioues. 
The  tablet  nay  thus  oe  used  for  maniculatino  or  oeoerating 
color  taoles#  directing  the  move rent  of  a software-generated 
cursor  on  the  display  screen;  selecting  oronram  execution 
options  from  a menu  of  logical  taolet  switches#  or#  with 
proper  application  of  lower-level  functions,  "sketching"  a 
display  onto  the  screen. 

The  modified  oesion  ai^nro3C^  that  «as  ta<en#  in  con- 
junction with  t-ie  tieref-structure  view  of  tnp  software# 


proved  highly  e 

fficient  ny 

prevent  1 

ng  the 

loss  or 

waste  of 

any 

previously 

oeve  1 CP'^o 

functions 

# while 

r e a 0 1 1 y 

identify- 

i nq 

any  1 ac  < of 

functional 

C a o a n i 1 i 

t / i n 

0 a r t 1 c u 1 

1 a r area. 

[he  envisioned  system  ana  the  newly  introduced  caoacil- 
ities#  in  order  to  oroyioe  a trulv  user-priented  environ- 


ment# reguireo  a continuous  reflection  pr  tne  user 
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psycholoqicat 
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Th<>  user's  basic 


osvcnological 
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peauiremeots  are  tine  necendert  117].  The  user  excects  cer- 
tain responses  in  a scecific  tirre  frane  or  he  becomes  frus- 
trated and  disoleasei  i t h the  svsten.  Each  specific  func- 
tion Mas  evaluated  for  possible  unfavorable  osycholcgical 
responses . 


The  psychological  nake-uo  of  the  user  was  of  pring 
importance  in  the  actual  oesigr  of  the  interactive  color 
manipulation  routine  taccolorC).  This  function  allows  thg 
user  to  interactively  modify  a n'j/oi'  create  system  color 
tables.  The  excectations  ano  oossible  frustrations  of  the 
user  were  researched  in  detail  in  this  reqara. 

Thus  the  user  «as  recoonized  to  have  certain  expecta- 
tions (171;  ano  a ccnce~t<»d  effort  was  made  to  ensure  tnat 
the  system  could  adeauately  meet  these  expectations.  The 
competing  properties  of  efficiency  ana  simplicity  remained 
fundamental  considerations  throughout  tre  develconental  pro- 
cess. 


When  oossiolef  tro  functions  ne  re  aesionea  to 
employ  "interaction  cy  an t i c 1 o a t i on " I 1 5 1 . This  approach 
decreased  the  reouir®c  numoer  o^  diagnostic  messaaes  an  a 
should  result  in  a more  satisfied  user. 

Satisfactory  response  times  ~“re  also  considered  in  the 
over-all  system  design.  It  was  found  that  users  could  become 
frustrated  ana  annoyec  by  tne  itr proper  timina  of  responses. 


For  e*amDl»»  -.her  a user  popfortrs  incorrectly*  the  system 
shoulo  not  r“SDon-j  imm eoiately*  Dut  oelav  from  t-.o  to  four 
seconds.  Ihis  delay  allows  tor  psychological  closure  on  toe 
user's  Dart*  after  wnicr  time  an  error  indication  is  more 
acceot  ab 1 e . 

The  logical  design  of  system  functions  thus  involved 
validation  of  existing  so^tw are*  aesian  of  new  software*  anj 
constant  reflection  on  tho  user's  osvcholoaical  neeos. 


V 


DOCU-'EM  AT 


The  document  at;  i or  effort  in  this  tnesis  ^or*'-  was  a con- 
tinuous orocess  that  caralleled  all  otner  erases  of  tne  oro- 
ject.  The  lack  of  sufficient  crior  documentation  was  con- 
sidtred  as  one  of  the  "■otivatino  factors  oehira  this  «or<. 
This  deficit  was  certainly  one  of  the  -ajcr  hinorances  in 
performing  the  object  system  design.  Therefore/  the  formula- 
tion of  proper  doc  Ljmer  t a t i OP  for  this  software  system,  in 
particular  a well-conceived  user's  manual,  was  of  utmost 
importance  to  the  designers. 


An  attempt  was  made,  throughput  thp  cesiqn/evaluation 
process,  to  record  every  binding,  every  result,  every 
achievement,  no  matter  how  insignificant  it  might  have 
seemed  at  the  time.  These  notes,  though  seemingly  unoraan- 
izeo,  served  as  valuable  reflections  during  tre  implementa- 
tion and  testing  phase,  as  well  as  when  this  writing  peg  an. 


It  was  the  ulttmafe  goal  of  this  thesis  to  develgr  a 
maximally  user-orienten  orachics  software  system  accompanied 
by  an  eoually  user-oriented  user's  manual.  i*-hout  the 
latter,  the  former  wculi  surety  go  unrecognized  and  unusea. 
with  this  in  ming,  a creat  deal  of  thought  and  preparation 


were  devoted 


to  develccino  such  a manual 


The  resultina  ■nanuat  (Ucoeo'lix  is  onant^eO  a)or«g 

the  foMowina  lines.  First  there  is  an  introouction  to  the 
basic  svsten  env’ronr.enr  and  to  the  nanua'  itself.  ?jext  is  a 
guided  tour  of  the  steos  r«»duired  to  gain  access  to  this 
environment.  This  is  followed  bv  a tutorial  review  of  tne 
basic  orogrammino  <no-.ledoe  a user  sroulo  possess  to 
aooroach  this  system  «itn  so’^e  oearee  of  confioence.  Ire 
next  Chapter  actually  oeoins  to  reveal  sc'e  of  tne  features 
of  the  graohics  oisolav  system,  am  oxooses  tm  r,  asic  rro- 
arammatic  control  functions  tne  user  ,«ill  ■■'eea.  Tre  remain- 
i no  chacters  (exceot  tno  last)  are  eacn  dovcteo  to  one  par- 
ticular functional  caoaPilitv  or  control  mcoe  of  tnis  sys- 
tem, This  will,  hQoe*ully,  nrovide  a more  Systematic  rev‘»la- 
tion  of  the  over-all  cao anilities  ang  features  of  the 
display  system. 

As  each  0^  tnes“  areas  is  exclored,  tne  associated  sys- 
tem functions  are  presented  in  a toP~down  fashion.  After  an 
introduction  to  the  nasic  application  area*  tne  hiow-level 
functions  are  introduced  first*  followed  rv  progressively 
lower  level  furctions.  fnis  aoproacn  was  taken  in  an  atte-ot 
to  alleviate  tne  difficulties  of  fn<»  novice  user  in  paining 
familiarity  witn  tne  syste". 

One  cnaoter  of  tre  •■•anual  is  devoted  to  eacn  of  the 
primary  interactive  devices  : tne  xevocard  ang  tne 

Vector  Genera'  Taclet.  Tno  ♦inal  craoter  presents  routines 
are  not  an  in te oral  cart  of  any  particular  functional 
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area t and  nad  thus  not  been  introaucea  panlier,  but  which 
might  Drove  useful  in  so're  arc  1 i c a t i on  s . 

Tne  indiviaual  system  f'jnc*’ions»  in  the  Lif'lIX  format 
16)»  are  included  as  •^ocendix  B for  ‘urther  clarification 
and/or  review  by  tne  user.  In  addition/  a cocy  of  the  source 
code  for  each  of  these  functions  (with  exolanatory  comments) 
is  available  in  the  daval  Postoraauate  Scnool  Laboratory. 
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VI.  r-'PL£*''E‘\iTiT  ION  i''jD  rESTIi'jG 


A.  PhEFERPEO  TECh.X'IGlE 

laealty  the  imolefrentat’ion  chase  ot  a co'^cuter*  system 
design  should  only  account  for  2S-30%  of  the  total  effort. 
The  functional  oesian  is  conclete  ano  a detailed  users 
manual  exists  for  tn?  orooosea  system.  Actual  i me  1 emen t a t i on 
should  then  consist  0^  codinn,  deougoinc,  and  local  wed 
test i no. 

Tne  coding  effort  snould  offer  little  challenge^  as  each 
function  has  oeen  laid  out  in  oetail.  It  should  ce  merely  a 
translation  of  ideas  into  a suitaole  medium  for  t^e  co'"“ 
outer.  Tne  deougoinc  of  each  function  affords  more  of  a 
challenge*  as  without  fail  loaic  errors  will  exist  in  the 
basic  des 1 on  . 

As  tne  dec u going  process  oegins  tne  documentation  must 
be  keot  current  or  in  tne  end  t r documents  will  not  accu- 
rately aepict  the  system  as  it  actually  cer forms.  if  docu- 
mentation ang  reality  ever  rogin  to  diverge  tnen  an  unten- 
able situation  is  linely  to  re  created#  in  the  form  of  an 
unma  1 nt  a ' nar>  I e svstem. 

As  functions  are  brouant  cn-line»  local  testing  will  oe 
conducted  — local  testind  oeinn  those  tests  cerformea  ny 
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the  oerson  resDonsible  for  a oarticutar  functions  imolemen- 
tation.  Ihe  problem  >/ith  this  local  testing  is  that  often 
the  tester  is  too  close  to  t^e  problem  to  oroviae  a poo a 
test.  After  the  local  testinn  is  ccmolete»  the  cetailea 
testing  of  the  function  should  be  performed. 

This  detailed  testino  should  be  performed  by  some  person 
or  preferably  some  group  of  Persons  who  nave  no  stake  in  the 
success  or  failure  of  the  system.  Ideally  this  testing  will 
be  done  by  a team  whicn  woulo  soeng  as  much  time  anc  effort 
developing  the  test  plan  as  went  into  the  design.  AM  too 
often  this  last  microscocic  testino  is  omitteo»  with  the  eno 
result  oeing  a system  full  of  imolicit  assumptions  and 
surprises  for  tne  unsuspecting  user. 

B.  '-'OOIFIfTO  TtCHMoiuE 

The  preferred  technioue  could  not  be  applied  to  this 
effort  am  was  trus  mogified  to  meet  certain  restrictions 
and  needs.  Hcoefully  the  end  result  was  the  same  leaving 
a viaole  and  truly  u se r-o r i en t eg  system.  The  reasons  for  the 
modifications  were  that  a test  team  for  the  thesis  was 
unrealistic*  ana  that  an  existing  system  afforded  a point  of 
departure  in  search  pt  the  u se r-o r i en t ed  system. 

I .'  vALIDAT  K;i.j/CCr.3Ev.\g  r IU\ 

Due  to  tne  fact  tnat  a sof''w are  support  Package  was 
already  in  existence  tor  rno  this  modification  was 
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injected.  It  amounted  to  navinq  three  erases  oeing  performed 
simultaneously.  The  three  erases  ^.ere  FUT'CIION  OESTGr'i,  OOCU- 
MEIMT  A r lU!'^,  aro  TFSTr^iG. 

While  operating  in  oarallel»  as  eroposeo  functional 
requirements  were  enumerated/  the  existing  software  and  its 
associated  doc umen t a t i on  «ere  searched  to  determine  if  such 
a function  already  existed.  Tf  the  existing  system  possessed 
such  a function  tren  the  valiaation/ccnaemnaticn  process 
began . 


This  process  was  fundamental/  as  it  either  yalinatea 
the  performance  of  the  function  or  it  caused  it  to  oe  con- 
demned. The  process/  trough  simcle  conceptual  ly/  was  one  of 
the  most  difficult  and  time  consuming  stages  of  the  systems 
evolution.  If  tre  function  performed  exactly  "as  adver- 
tised"/ then  the  action  was  to  merely  fiocument  and  continue, 
when  the  function  did  not  act  as  expected/  then  the  often 
lengthy  ann  involved  search  oegan  * or  tre  sometimes  illusive 
logic  error. 


cer t a i n 1 
tern,  r h i 
tern  to 
t hough  t 


The  need  for 
y created  oy 
s inaaeduate 
fall  prey 
of  using  j sv 


this  unrewarding  experience  was  most 
inadeouate  testing  of  the  previous  svs- 
testing  han  also  causen  the  "old"  svs- 
to  idleness/  as  users  ao  not  relish  the 
stem  full  of  frustration  and  surorise. 
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2.  IMFLEi“'EN  f A r lOi. 

The  funae-nental  suocort  functions  of  tAe  predecessor 
to  this  use  r -o  r i en  t e 0 systerf  haa  oeen  installed  ana  tested 
prior  to  the  start  of  rhe  i mp  1 e'^en  t a t i on  phase  of  the  rroci- 
fied  approach.  The  volume  of  chanae  »as  small  when  viewed 
against  the  entire  system,  cut  essential  in  a truly  user- 
oriented  system. 

The  actual  cocing  effort  of  the  selected  additions 
to  the  now  deoendable  case  system  only  accounted  for  accro*” 
imatelv  1U%  of  too  total  effort.  This  phase  was  actually 
conducted  exactly  as  discussed  in  the  PSEFEdKEU  TEChMlC, Ut 
section.  Unce  the  coding,  debuooina,  and  localized  testing 
was  completer  then  detailed  system  testing  began. 

3.  HE  tailed  TESTI'-iG 

The  detailed  testino  of  the  overall  system  was  con- 
ducted in  compliance  with  the  preferred  technioue.  Trp  use 
of  an  external  testing  source  was  not  ■^easicler  thus  these 
suggestions  were  cent  sliah*:ly  to  accomodate  the  cir- 
cumstances of  the  desion. 


The  dual  thesis  effort  afforoed  a y i ar 1 e test  via 
oscillation  of  duties  cetween  designers.  The  person  respon- 
sible for  the  actual  i "^p  1 emen  t a t i on  of  a function  was  not 
responsiclp  for  it's  testing.  Thus  the  designer's  counter- 
part cecame  tne  devil's  advocate  du''ino  the  formal  test 
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phase 


In  aaaition  tc  t^e  forTal  testina,  user  testing  v«as 


not  only  encouraged  but  soucht.  Tne  svstem»  when  Dossible# 
was  made  available  to  users  --  reauestino  that  they  convey 
their  likes  ang  disli<es»  successes  ana  failures.  The  sys- 
tem»  having  oeen  designed  for  the  user,  was  then  evaluated 
very  critically  from  user  comments.  for  the  most  cart 
reSDonse  was  favoraole.  ‘ihen  unfavorable  resconses  oc.curred 
they  were  studied,  arc  every  afte'-ct  was  maoe  to  restructure 
those  ascects  that  were  found  to  fie  distasteful. 

a.  Cul'irifvUtD  TESTI'iH 


i n 

0 r de  r for 

a 

svstem  to  r 

e a 1 1 y claim 

to  be  user- 

oriented. 

i r 

must 

ce 

P 1 3oed  i n 

a continual 

test 

D 0 s t u r e . 

This  c on  t i 

rua  1 

t es  t i 

og 

is  i n f 0 r m a 1 

but  allows 

for 

resoon se 

to  user 

C r i t 

i C i sm  . 

The  user  is 

afforoed  the 

f ac  i 

1 i t y for 

voicing  his  orob'ems  with  the  system.  These  user  assessed 
oroblems  must  be  evaluated  anih  acted  ucon.  The  action  need 
not  be  drastic,  ill-advised  system  modification,  out  an 
honest  look  at  *'he  croblem.  If  corrective  actions  are  in 
order,  tren  the  documentation  and  software  must  be  modified 
in  un i son  . 

The  wixTth  GX-10)A  orachics  succort  syste™  is 
Currently  installed  and  umdr>rdoind  tne  continued  testing 
ohase.  There  are  no  vnown  oroclems,  cut  the  facility  for 
voicinn  Such  oroblems  exists  in  toe  form  of  a trouble  recort 
attached  to  the  device. 


Vll.  RtCOVViENDA  r lOf'jS 


The  svste^r  as  ccnfiaureOf  should  new  offer  a oroduc- 
tive  develooTental  environrr. ent.  This  newly  created  environ- 
ment  will»  hopefully/  encourage  fresh  innovative  research  in 
new  applications  of  color  orachics.  Twc  such  areas  surface 
almost  immediately  as  Ii<a1y  candidates  for  meaningful 
research.  These  two  areas  are: 

CO'-'WAMD,  COMTf^OL,  A.'jC  CC  C A T I P % ; ann 
6 I u A L P H 0 C E S 3 I f'l  G . 

Tne  command/  control/  and  communication  applications 
are  Dounoed  by  imagination  alone/  as  this  fiela  is  still 
evolving.  The  field  of  computer  graphics  will  most  surely  be 
one  of  the  f r o n t ” r u n n e r s in  the  implementation  of  such  sys- 
tems. The  co’or  capabilities  of  the  ‘^A’-'TEk  should  orovice  a 
Powerful  tool  in  this  redarn. 


L i m i 

ted  signal  processino 

aoo 

Heat 

ions 

have 

a 1 ready 

been 

pe 

rformec!  on  the  device. 

T o 

new 

system 

s h ou  1 d 

encourage 

more  use  of  color  in 

this 

e r«a  . 

The 

color 

d i sc  1 ay 

will 

mes  t 

certainly  ccnvev  more 

useful  in 

formation. 

in  addition  to  the  new  applications/  it  would  oe  cene- 
ficial  if  the  saving  o^  comrlefe  screen  images  were  cossi- 
ble.  The  memory  spac“  roduir'^d  for  this  aoolicaticm  would 
reauire  serious  consideration  out  could  oe  arranneo  to 
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permit  efficient  utilization.  The  "■enory  readoack 


i n t e r f ac  e 


was  not  installed  on  tnis  eciuip'^ent/  out  /.im  its  installa- 
tion ana  minor  software  efforts  it  woulo  he  possible  to 
memorize  screen  imaces.  This  memorization  crocess  coulo 
eliminate  the  need  for  repetitive  orocessinq  while  providing 
a Powerful  tool  for  the  user. 


The  support  liorarv  exists  as  a seoarate  entity  and  is 
intefaced  via  t^e  C crcaramminc  lanpuage.  Possible  researcn 
on  the  capaoility  to  access  this  licrary  via  ctner  languages 
woulr.)  he  a worthy  experience. 
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The 

ever 

continuing 

maintenance 

of  this 

ana  all  of 

the  ; 

systems  i 

s of 

the  utmost 

imoortance. 

5 i m i 1 a r 

efforts  as 

i 

ji 

con-  > 

i, 

ducted  on 

the 

RA'V'TEk  coul 

0 oe  undertaken  for 

other  aracics 

1 

devices  i 

n the 

1 abcra*-orv 

VIII 


CCrjCLIJS  IOTjS 


An  existing  sott'/var^  suDcort  oacxage  .•^as  cisasse'"blea/ 
then  restructured^  tested/  and  excanged  into  a usadle  color 
graphics  disolav  svsten^.  The  goal/  as  a use  r -o  r i en  t ed  sys- 
tem!/ was  achieved/  ouf  tre  design  aporoacn  ang  the  solutions 
to  DrodleiT's  encountered  ottered  the  real  lessons  in  this 
learning  orocess.  These  .vere  the  Tiost  imogrtant  results  to 
the  des i goers  . 

in  redesigning  a software  svste'r  oaseo  on  a prior 
design/  it  was  oossiole  to  have  20/20  hindsight  in^o  the 
failures  of  the  previous  attempt.  The  post  orotoun;]  iuoge- 
nent  derived  is  that  detailed  olanning  Tust  precede  iirole- 
r'entatioo  efforts.  Tre  parent  svsten  that  spa-*nec  this 


u s e r -o r 1 en t e d child  was  not 

planned  in 

oe  t a 1 1 

nor 

we  1 1 doc  u - 

Tented,  ^ad  the  steos  utili 

zee 

in  d e V e 1 

o 

c 

c 

o 

this 

new  design 

oeen  epcloyed  in  toe  crev 

1 ou  s 

effort/ 

there 

w 0 U 1 

Id  rrccadly 

have  oeen  no  need  ton  'hajor  revision  ana  exhaustive  testing, 

Ihe  svste'h  has  oeen  installed  ana  tested.  Aggauahe 
docunentation  has  oe“n  provided  to  assist  users  in  the  effi- 
cient use  of  the  device. 
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APPENDIX  A 
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USERS  ■-'ANUAl  RAMTEx  GX-IOOA 


This  rrsnual  is  cesiqned  to  □'•ovioe  t^e  users  oT  tne  RA^'T£'<> 
qraphics  oisclav  device  a convienient  and  sir’cle  introduc” 
tion  to  tne  oevice.  Tne  ~anual  allows  for  as  detailed  an  in- 
vestigation into  tne  svsten  as  the  user  desires. 
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IMkOO  JC  T IOiM 


The  W'VMTtK  GX-IOOA  qraohics  displ'3y  syste""  utili2es  a 
raster  scan  technique^  with  the  disclav  innaqe  data  oeina  ex” 
tracted  from  an  internal  refresh  meTiory,  The  RAN'THK  system 
in  the  •yaval  Rostdraduate  School  Como u ter  Laboratory  is 
hosted  ov  a RDP-11/50  come u ten  and  is  accessed  throuch  this 
computer,  ann  its  L-'lI*  operating  system,  from  one  of  the 
terminals  in  tne  Lao. 

It  is  not  the  int®nt  of  this  manual  to  oreviae  a de- 
tailed analysis  of  the  hardware  or  internal  functions  of  the 
RAMJEk  device,  cut  rather  to  expose  the  user  to  t"®  software 
support  oacooe  that  has  ceen  aeveloceo  for  it.  This 
software  cac'<3de  consists  primarily  of  a system  library  of 
subroutines  written  in  the  'C'  orcoram-ning  languace.  Includ- 
ed in  this  1 i n r a r Y are  a number  of  routines  that  pnaole  the 
user  to  interface  the  RivTEh  with  the  Vector  General  Oata 
Tablet  in  the  Lac. 

A review  of  the  Table  of  Contents  would  reveal  the 
basic  organization  of  ttis  manual  to  ce  as  described  here. 
Following  this  Introduction  is  a charter  devoted  to  ♦ami- 
liarizinq  the  user  with  th»  envircnmont  in  which  tnis  nraph- 
ics  system  exists.  Tne  next  cnaot^r  cresents  tre  funejamen- 

rpouired  of  a prospective  user. 
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t a 1 c rocr amm i ng 


X now  1 e hge 


Following  this#  the  basic  control  functions  of  this  system 
are  oescribea.  f. ext  the  user  is  intrcauceo  to  tne  data  ta- 
blet interfacing  routines^  follcwert  cv  colcr  maniDulation 
techniques.  After  this/  there  are  eiort  cnacters  that  eacn 
describe  cne  of  the  control  mooes  of  the  GX-IOOa.  Then  co-es 
a chapter  Oetailina  the  use  of  the  interactive  key o oar o.  Tne 
final  chapter  discusses  the  remainoer  of  the  software  sup- 
port oackage.  /here  appropriate/  the  separate  chapters  are 
oivioed  into  three  sections  : Introcuction/  oas’C  '.'ser 
Guidelines/  ann  Acvanceo  t.^fhcds. 

The  nranual  will  serve  as  a tutorial  on  tne  subroutines 
available  to  the  user  for  generating  cisclays  cn  tne  rA  r ' T F h 
terminal.  There  are  numerous  sample  programs  included  to  al- 
low the  user  to  become  familiar  with  operating  the  system 
and  to  exhibit  certain  features  that  are  available  in  the 
RAMfEK  • software  support  oackaae.  These  sample  orocranS/ 
along  with  seve-al  larger  aemonstration  programs/  nave  oeen 
compilea  into  a special  directory  in  the  host  computer  file 
system  (see  Operating  Instructions).  The  user  is  encouraged 
to  execute  each  of  these  samples  as  he  progresses  through 
this  manual. 

For  the  user  that  regijires  a more  aetailea  Knowledge  oT 
the  internal  functioning  qf  the  device/  the  PA'TtK  G<-100A 


Programming  ^anual  (11  is  available  in  the  Lab 


II.  CPEt^ATING  IMSTRIjC  f 


The 

bAVTEh  display  device 

i S 
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e d via 

the 

..  „ .1 

3 1 

oe 

POP-l 1/bO 

in  the  Computer 

Lab, 

t)  V 

I.J  s 1 n a 

one  of 
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t e r r • 

1 n a 

1 s 

connected 

to  this  c omcu  t e r 

. If 

the 

user 

is  not 

f a .m  i 

liar 

M i 

t n 

oteratinn  of  <r®r""in,-jls,  np  sncjl'l  consult  tn®  Ter- 

minal User's  f-'anual  IcI  availaOl®  ir  t"e  Uao. 

in  orner  to  utilize  tip  R«'’TEn»  t^e  oevice  "ust  be 
’’cowerea”on"  and  succonteo  by  the  PO^-ll/SO  conputen.  ^ v 
followinq  the  \ d stecs  listen  beloi«f  toe  user  will  ensure 
himself  of  a successful  session  wit^  '•^e  eduiomenr. 

1.  Ensure  the  "A"  sine  PDP-11  comoufer  is  in  operation, 
(If  in  ooubt f chec<  with  Lab  staff.) 
d , Check  the  qreen  power  surolv  liqht/switch  (marken 
"PAN!TE*f  POi,E°")  at  rrp  lower  rear  of  th®  nosr  POP-11. 
If  this  switch  is  hiQT  illuminated/  contact  one  of  tie 
Lab  personnel  for  assistance.  InniscriTirate  use  o’- 
this  switch  will  cause  the  host  eystem  to  "crash", 
i.  Apply  power  to  the  PiMTEK  kevboaro  ano  monitor  : 

a.  the  oreen  "P0;‘. hP"  switcr  on  the  upper  riq^t  por- 
tion of  the  Kevboaro  should  re  illuminated;  if 
not/  depress  tre  switoh. 

b.  select  the  "Cl."  position  cf  tre  selectnr  <nop 
the  lower  left  comer  of  r-e  COlcr  oisclay  rrmi- 
tpr,  (See  Pin.  11 
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(oPt i ona 1 

) select 

the 

"QM" 

Position 

0 f 

the 

power 

switch  on 

the  1 

owe  r 

f r on  t 

Dane  1 of 

the  black  A 

white  m 0 n i 

tor  (Sen 

F i a . 

1 ) 

(optional 

) select 

the 

"O'v" 

Position 

0 f 

the 

c 0 we 

switch  on  the  vector  Genf?ra1  Data  laclet. 
a,  Cnoose  o'^e  of  tne  "A”  siHe  ter-mnals  ano  turn  it  on. 

At  this  coint»  the  user  is  reaav  to  )oq  into  the  UiJiX 
ooeratino  system  anc  proceed  witn  tne  session.  The  user  rnat 
intenas  to  execute  one  or  no'~e  of  the  samole  croyrams  from 
this  manual  cr  view  ere  of  tne  Pif-TEh  Oemorstration  croarams 
shoulc  continue  with  steo  S.  For  the  user  tnat  has  oeen  es- 
tadlished  in  the  system  with  nis  own  ioentification  ano 
directory/  tne  most  cemmen  activity  is  orocram  cevelcrrent 
and  testina.  This  user  is  assum.eo  to  he  familiar  witn  tne 
operatino  environ ment  ano  is  referred  to  Chapter  Iv,  Pro- 
arammatic  Control  of  the  RAf-TEh.  The  user  »itn  cniv  "-o'"erate 
experience  in  th«>  hivlx  environment  may  wisn  to  scan  hnapter 
III/  ^asic  Procram-ino  R e ou  i r em  «■  n t s / hefere  prcceecino  to 
Chapter  Iv.  Inese  users  may  return  to  step  !0  helow  for 
termination  croceoures. 

5.  At  the  selected  terminal,  the  completion  of  the  foi- 


J 1 C w i no  s 

eduence  will 

lead  the 

user 

to  tne  system. 

i 

^ m' rectory 

that  contains 

the  sample 

ano 

cemor. St  raf  i on 

^ c roqrar  s 

(note  ; lower 

-rase  tvee  ■ 

i mo  1 i 

es  a user-tv c“d 

I 


command,  uccer-case  tyre  o“notes  a system  reoly,  ''■4" 
is  the  U’vl»  rromc*’  siqnal,  anq  "c/r"  means  secress  the 
RETURN  »“y)  ; 


LCGI\:  CS2000  c/r 


PiSSwCf?0:  student  c/n 
X cd  ramteif  c/n 

b.  To  deter-nine  w^at  source  cpograms  are  available  +or 
insoection»  ttie  user  should  tyoe  : 

Is  * .c  C/r 

This  will  result  in  a listino  of  the  names  of  all 
files  in  tne  cs20  0 0/  ramte<  'directory  that  are  of  tvoe 
".c".  This  list  of  file  names  will  accear  on  the  ter- 
minal screen.  The  files  that  are  named  ol.c  throuon 
ocJO.c  are  samole  orograms  that  are  describea  later  in 
this  manual.  Tne  other  files  listed  are  of  no  concern 
totheuseratthisrime, 

7.  To  insoect  one  these  files*  tne  user  should  tyoe  : 

list  -c  filename. c c/r 

c/r 

where  "filename"  denotes  the  namo  of  tne  oarticular 
chosen  file.  Tne  second  (ana  subsequent)  "carriaoe 
return"  will  cause  the  next  "oaqe"  of  source  cooe  to 
be  orinted  on  the  terminal  screen.  For  examcle*  to 
insoect  the  source  cod®  of  the  tirst  samnle  rroaram, 
the  user  woulj  tyoe  : 

list  “C  ol.c  c/r 

8.  To  execute  one  of  the  samole  orograms  and  y’ew  th» 
resultino  disolay  on  the  Ri*''T[iK,  the  user  shou'd  tyo®; 

filename.x  c/r 

where  "filenamo"  is  the  name  of  the  selected  samole 


a H. 


C roq  ram 


After  decressima  the  REruW‘-i  key 


t ne  user 


should  turn  his  attention  to  the  cisnlay  screen. 

9.  In  addition  to  the  sample  programs  mentioned  above# 
there  are  also  ■four  demonstration  orograms  in  the 
cs2000/ramtel<  directory.  A detailed  explanation  of 
these  demo  orcarams  can  be  found  in  the  "User  Entry 
Manual"  121.  To  view  the  first  of  these  demonstration 
programs#  the  user  should  type  : 

rami  c / r 

Subseouent  demo  orograms  are  called  ram2#  ram3#  and 
rarny.  These  demo  oroorams  offer  the  user  the  oDpcrtun” 
itv  to  interact  witn  the  RA^'T£.i<  keyboard  ano  the  rjata 
tablet. 

After  completing  the  desired  work  for  one  session#  the 
user  Should  proceed  to  steo  10  for  termination  procedures. 

10.  For  the  user  who  is  currently  enitina  a file  (ie# 
creating  or  modifying  a file  in  his  own  or  a class 
directory)#  care  must  re  tai'en  to  ensure  the  latest 
a gd  i t i o n s / c o r r e c *■  i 0 n s are  incorporated  into  ris  pro- 
nram.  This  is  accomplished  bv  tyoing  at  the  terminal  : 

w filename  c/r 
Then  typing  : 

a c/r 

will  get  thp  user  out  of  the  "edit"  mone.  (see  Chap. 

Ill  ) 

11.  To  tehT.  ihate  the  session  on  the  terminal#  type  J 

du 1 t c/r 
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li?.  To  "oower  riown 


the  ■-^A'^TEK 


the  followinQ  steos 


should  be  acco'^oHshed  : 

a.  Tucn  off  the  green  oower  switch  on  tne  f?AVTEK 
<evcoarfl  by  depressing  tne  switcn. 

b.  Select  tre  "OFF"  oositior  of  the  selector  knoo 
at  tne  lower  le^t  corner  of  the  color  display 
non i t O r . 

c.  If  the  black  i write  monitor  is  On,  select  the 
"OEF"  cositinn  cf  ihs  oo«er  Switch  on  tne  lower 
tront  canel. 

a . If  the  Vector  General  Tablet  was  being  used, 
select  the  "OFF " nosition  of  its  oower  switcn. 


5'T 


BASIC  PBOG» a'-^N’ nr,  perjuif<E''''ENTs 


w 


III. 


In  order  to  utilize  the  RAi^’TEr'  cisoley  cevice  the  user 
must  have  access  to  the  comouter  laboratory  and  a Icain  name 
in  tne  UI'.  n time  sharinq  system.  The  fact  that  tre  user  is 
estaolisheb  in  toe  iji'ix  ooeratina  system  allocates  the  scace 
reouirea  for  crooram  cevelocment  . There  are  two  secarate 
POP-  ll/oO  comouters  in  the  laboratory  ana  they  are  referred 
to  as  the  "A"  and  "d"  sides,  loe  "A”  sice  hosts  the  arcohics 
oisolay  devices  of  toe  laboratory;  the  "d"  sioe  is  used  for 
qeneral  oroaram  oevelcoment.  In  order  for  a user  to  effec- 
tively utilize  the  svstem  oa  snoulo  have  access  to  both 
sides  . This  allows  the  user  to  create  and  oecug  proorams  on 
the  "H"  sioe»  then  execute  the  oroarams  on  the  "A"  sice. 


The 

C O roc  ram 

'T'  i n g 

1 an 

d u a o e 13)  « 

as  used  1 0 

d e V e 1 0 o 

the 

software 

suoco  r t 

f 0 r 

the 

P A Vi  1 E h and, 

as  such,  the  user 

win 

be  reaui 

red  to  D roc  ram 

i n 

C in  0 r d e r 

to  inferfac 

e with 

this 

software 

. r n e C 1 

n G ij  -3  a e 

is  similar 

to  FlJrTr^M^J 

out  o r 0 V 

i des 

a oreat 

deal  more 

flex 

i b i 1 

itv.  A C nrocram  ccnsi 

s t s of 

data 

dec  1 a r a t 

ions  a n 1 

one 

0 r 

mnre  fijnct 

ions.  This 

1 anouace 

n a s 

five  funiamental  riata  tvoes; 
int  (irtoqer) 

Char  (nyfol 

float  (simqlo  nrecisiom  floatinq  ooiht) 
double  (dourle  precision  tloat’no  oointj 


J 
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1 


reqister  (sa't'e  as  int  excect  in  a reaister) 
Declarations  may  be  made  internally  or  externally*  «itn 
respect  to  a tunc^'ion*  indicatino  either  local  or  global 
scope  respectively.  Global  scooe  imclies  that  the  variable 
is  known  to  all  functions  that  follow?  local  scoce  implies 
that  only  the  function  that  contains  the  declaration  has 
knowledge  of  that  variable. 

A function  consists  of  a set  of  statements  enclosed  in 
braces  ({>).  Every  C orocram  must  contain  a function  called 
"main"  since  execution  of  a C orcgram  becins  with  the  tirst 
statement  of  "main".  All  functions  must  be  explicitly  de- 
clared (includinq  "main”)  by  a Statement  of  the  form  : 
functicn-nameCoctional  arouments).  The  optional  arguments 
are  the  wav  that  data  are  communicated  between  functions. 
The  arguments  must  be  enclosed  in  canenthgsis  and*  even  if 
no  arguments  exist*  tne  carent''esis  must  always  be  present. 
The  statements  within  a fijnction  are  always  terminated  with 
a semi-colon  and*  as  creviouslv  stated,  the  boav  of  the 
function  is  erclosen  in  braces,  "'-'a  in"  will  normally  i.nvo<e 
other  functions  to  certorm  certain  tas<s?  this  is  accom- 
plished by  stating  the  function  name  followed  by  the  argu- 
ment list  ang  terminated  nv  a semi-colon. 


rt  i t h 

1 anquage 
programs  o 
i s 


this  very  Cursory  loo* 
the  user  should  re  aole 
* this  manual  and  write 

ercouraoe,7  to  rpao 


at  the  C oroorammirg 
to  understand  the  example 
simple  C programs.  Th^ 
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user 


e r c O u r a c e d 


the  C tutorial  l-J]  ang  fhe  C 


reference  'ranuel  [3]  for  a more  'letailecJ  oescrioticn  of  tne 
1 anguane . 

If  is  assumea  here  that  tr.e  user  has  so'^e  knowledge  of 
the  UMX  onerating  system,  at  least  to  tre  level  of  having 
read  the  "U\IX  for  rteainners"  tutorial  [51.  Thus  he  will 
understano  that  files  may  be  created  by  invoking  the  LH'jIX 
TEXI  EDITOR/  giving  the  command  to  aooend  information  to  the 
file/  inserting  the  information/  terminating  the  accena 
mode/  and  ««ritinq  the  file.  The  following  short  exercise 
should  refresh  the  users  memory. 

LOGI'l:  "user  login  name"  c/r 

PASS«»0RD:  "user  oassworg"  c/r 

ed  samole.c  c/r  Cinvokes  text  editor) 


a 

c/r 

(enter  aooend  rode) 

m a i 

n ( ) c/r 

{ 

int  a/O/total; 

c/r 

a = 1 ; b = a; 

C / n 

total  = a c 'r 

c/r 

orintf(''s.jm  IS 

T^dO / total);  C/r 

} 

c/r 

• 

C/r 

ft 

c/r 

( w r i t “ file) 

r* 

C / n 

(cuit  edit  mooe) 

This  example  creates  a file  (C  orogram)  calleo  samole.c 
that/  «nen  comcileo  and  execute  ■)»  sums  two  intecer  values  a 
and  b info  total  ang  tnen  orints  the  result. 

5 3 


The  user  shoul<J  recall  that  in  order  to  comoile  a C 


Drogram  he 

.must  i n V o '<  e 

the 

c 

compiler  by  using  the 

" c c " 

com- 

mand . 

To  comoile  the  aoove 

e X 

ample  the  user  would 

type  : 

cc 

Sam 

D 1 e . c c / r 

The  result 

o f a C C omo i 

1 e i 

s 

an  executable  file  named  a. 

ou t . 

This 

file 

is  created 

i f 

one  does  not  already  ex 

i s t or 

re- 

places 

the 

old  a . ou t f i 

1 e i 

f 

one  existed  oreviousl 

v . In 

ora- 

e r to 

save 

an  old  a. out 

f i 1 

o 

the  user  may  rename  i 

t b V util- 

i i i nq 

the 

U^!^X  function 

" ,T  V 

It 

For  the  user  to  save 

t i^e  a 

.ou  t 

file 

created  by  concil 

i n g 

sannle.c  re  could  tyce 

: V a 

.out 

samole  c/r  . Tnig  cnanoes  the  na-po  r)i  a.otjt  to  satrole. 


■! 


Having  been  refresn'^c  on  tre  very  basics  of  the  C cro- 
gramminq  lancuaoe»  '.IX,  and  conoilation  croceoures,  the 
user  is  reaav  to  begin  ../riting,  conoiling,  and  executing 


programs 

soec i f i c a M y 

for  the  hil 

'’TEh  graohics  di 

so  1 a V 

de  V - 

ice.  The 

user-oes i oneo 

pr.oqrams 

'or  tne 

A .'i'  T £ K 

wi  1 

1 D e 

deoenoen  t 

uocn  the  -ViJivtE 

h software 

s uopo  r t 

1 i b r a n y 

. T h 1 

3 1 1 - 

brary  contains  a muititij 

■ie  of  user 

oriented  rout 

i nes 

that 

allow  hi 

m to  oertorm 

certain 

t as  X s on 

the  dev 

ice. 

These 

routines  are  actuallv  C 'unctions  ana  in  oroer  t^  invoice  one 
the  user  must  only  it's  name.  Since  this  sunoort 
routine  is  not  <githin  the  user  oefined  C orogran,  it  is  un- 
defined unless  a 'inw  is  crovioed  to  ’■re  succort  library. 
This  lin«  is  orovided  via  a shell  corrmann  calleo  "ramte<". 
Thus  in  order  to  comoile  a orooram  that  references  functions 
contained  in  the  licrarv,  tne  user  tvoes  : 


r a n.  t e '<  f ' 


D n a m e . c 


b4 


1 

■i 

I 

J 


c / r 


This  will  issue  a cc"  command  with  the  aoDrooriare  parame- 
ters to  link  to  the  software  supoort  library  ana  resolve  tne 
previously  undefineo  function  calls.  The  followinq  example 
typifies  this  procedure: 

LOGIM;  "loain  name"  c/r 
PASSrtOHD:  "user  password"  c/r 

ed  CT5.C  c/r 
a c/r 
ma i n ( ) c/r 

(ramtekC);  erase()J  c/r 
d i so ( 7 ) ; c/r 

y c/r 


Q c / r 

ramteK  CT5.c  c/r 

The  result  o'^  tne  aoove  example  /.ill  oe  the  creation  of  a 
file  CI5.C  fthe  source  code)  and  an  a. out  file  (the  execut- 
able file). 


As  oreviokisly  stated  the  user,  for  efficiencv  reasons, 
should  create  and  compile  his  proqrams  on  the  "P"  side  of 
the  laboratory  facilities.  If  the  user  has  followed  this 
quideline  he  now  has  an  executable  orooram  that  will  display 
some  colors  and  text  on  the  f’A'-'TEh  screen  (the  user  should 
not  oe  concerned  wifh  how  this  is  acre,  put  merely  with  the 
procedure),  but  the  executable  croqram  is  on  the  "b"  si3e 


and  the  "A"  side  actually  hosts  tne  orachics  display  dev- 


ices.  The  user  Tiust  then  transnort  his  executable  proaram 


from  the  "B”  siae  to  tne  "A"  side. 


The  t r ansoo r t a r i on  of  information  from  the  "8"  to  the 
"A"  side  may  be  accomolisned  by  using  tne  system  functions 
"put"  and  "get".  In  oroer  for  the  user  to  transfer  the 
a. out  file  created  from  the  compilation  of  CTS.c  he  must: 
(llbe  logqeo  in  on  both  sides  simultaneously 
(2)frorr  tho  "d"  sine  tvne 
out  a. out  c/r 

(the  system  i«ill  respond  DOIJt:  when  the  action  is 
comp  1 e t e ) 

(5)frcm  the  "A"  side  fyoe 
get  a. out  c/r 

(the  system  will  respond  with  DONE  when  finished) 
fjow  the  a.out  file  create  a earlier  resioes  on  both  sides  of 
the  laooratory's  ?DP  11/50  computers.  The  user  is  also 
loggeg  in  on  both  sides  and  should  logout  of  the  "8"  side  in 
consideration  of  other  users.  The  user  -nay  now  execute  his 
program  am  see  the  PA-'TEK  resoonso.  Prior  to  execution  t^e 
user  should  ensure  that  the  GX-lOhi  is  oowereo-on  according 
to  the  first  three  steos  in  the  chapter  title o OPEPATIfu;  Ib- 
STPUCIIOMS.  For  the  user  to  nnw  execute  t^e  program  he  must 
type  : a.out  c/r  . Tne  hA<iTEh  should  resnono  with  a gisrlay 
of  assorted  colors  ang  alphanumeric  dafa  on  the  screen  ang 
the  term,  inal  should  respond  with  the  prompt. 


The  user  'nav  also  use  I’-’PC)  and  EXP()  (see  UWiX  cro- 
qrammers  manual  Col)  ^or  *-ne  t ransporr  at  i on  o i r f o r ma  t i on  . 
These  routines  provide  two  way  communication  but  have  cer- 
tain restrictions  trat  miake  then  a secona  choice. 

The  user,  havino  followeo  the  CTS.c  exanple  to  conole- 
tion»  now  has  two  copies  ot  t^ie  sane  file.  One  file  is  on 
the  "A"  side  ana  the  other  fil=  is  on  the  "'3"  siae.  This  du- 
plication of  cone  IS  a waste  space  am  as  such  the  user 
should  renove  one  nf  the  copies.  Inis  re^ova’  can  oe  acccn- 
clished  oy  usina  tne  sys^e-  routine  "r"-",(type  rn  a. out  c/r) 

The  user  is  now  crecane'^  to  nove  into  toe  srecitics  ot 
the  RAN'TEh.  support  cacoae.  ^or  nore  a^tailen  internation  on 
Cf  UMIX,  anvd  the  use  of  svsten  t^rni^^is.  refen  to  toe  ap- 
propriate docunent  in  tho  larora'’ory. 


I 


IV.  PRCG'^AWATir  CGMGOL  of  THt  pA•v.TE^ 


A.  Openina  tne  Oevice 


There  is  one  liorarv  sunroutine  that  “'UST  se  caMea  in 


every  program  that  applies 
oe  the  first  such  subroutine 
ately  named  "ramte<"»  ooens 
access  to  it.  This  will  also 
fresh  memcrv)  of  any  prior 
follows  : 

ram  t 


to  hhe  PA^'TEh,  ana  it  must  also 
calif"").  This  routine/  aopronri- 
the  oevice  ana  estaolisres  user 
clear  the  screen  (ana  fne  re- 
cisolav.  The  call  may  aooear  as 

? )c  ( I ; 


As  mentioned  nere/  this  must  be  the  first  RAi^TEK  subroutine 
call  in  the  user's  prooram.  This  routine  will  return  a 
value  of  negative  cne  (-1)  i't  unable  to  ooen  the  device, 
otherwise  it  returns  a zero  value.  Tne  return  of  a neoative 
number  to  indicate  an  error  condition  is  common  practice  in 
this  system  ana  its  ooeratino  environment.  The  user  should 
consult  Aonenoix  t)  to  fing  the  oroner  ciaanost'c  information 
for  each  routine  in  tne  so'^tware  support  packaoe. 


B.  Virtual  Screen  Oirrens>on<; 


In  oraer  to  develoD  functional  oroarams  aoolication 

to  the  RAMTEK,  the  user  -^ust  Oe  aware  of  the  ccncect  of  tne 
"virtual"  scheen,  wnic'^  means  tne  user's  v'ew  of  the  screen 
will  aiffer  from  the  real  hardware  c on f i ou r a t i on  . The 
aisplav  screen  may  he  tnnuoht  of  as  ceinc  ma-je  uc  ct 
horizontal  lines*  each  consisting  of  oeO  elements.  (Each 
line/element  comoination  is  calleo  a "ci^el".)  In  reality* 
this  oevice  hgs  51?  raster  lines.  Due  to  certain  interfacing 
restrictions  it  has  oeen  mngifieo  to  allow  only  utl  of  t^ese 
lines  to  oe  visiole.  1 he  otner  3?  lines  exist  eft  tne  rottom 


of  the  screen 

and  are 

0 f 

no  concern  to 

the  user 

except 

when 

the  "scroll" 

rout i ne 

i s 

emcloveo.  (see 

Special 

Aon)  i c a t 

ions 

Routines"*  Chac  i<vl). 

A 1 1 

other  display 

routines 

in  the 

Sue- 

port  oaeixage  mac  tne  user'-  a 0 presses  onto  the  ^60  visible 
lines,  bince  this  r, x-10  0^  accesses  these  visible  lines  in 
pairs  rather  tnan  inoiviriually*  the  result  is  adoress- 
able  lines.  Thus  the  initial  view  of  the  screen  coulc  re 
that  of  a o^O  bv  ?40  orio  with  the  coordinates  (0,0)  in  tne 
upcer  left  comer  ano  the  coordinates  (o'i0*?-i0)  in  the  lower 
right  corner.  This  is  ';QT  the  view  that  is  used  when  operat- 
ing through  the  SA'-'rt'h  suocort  oactaoe. 

The  software  support  ro^tiwes  nave  been  oesioneg  q 
transform  the  screen  into  the  more  conventional  "Cartesian" 
aria  pattern  that  has  its  minimum  values  in  tne  lower  left 
corner  ana  its  -aximg-  values  in  the  uccer  rignt  corner. 


Thus  the  user  views  a virrual  screen  as  described  tv  an  or- 
dinary Cartesian  ario  systena. 

It  should  be  noteo  here  that  the  initializinq  "rairteit" 
routine  di^nensions  the  virtual  screen  to  100  X lu0»  with  tne 
lower  lett  corner  recresentinq  the  ooint  (O.OfO.O)  anq  the 
uDper  riohh  corner  ( 1 0 0 . 0 , ! 0 0 . 0 ) . 

Hy  utiHzinq  tne  routine  callen  "screen"  the  user  may 
dimension  the  virtual  disrlav  screen  to  any  desired  size»  as 
long  as  the  coordinates  con'^npT>  to  fre  conventional  oattern. 
The  call  is  of  tne  tor-  ; 

Screenf  <mi  n,ymin  / x - a ‘ »v"ax  ) ; 

where  the  oarameters  are  real  numbers  tnat  represent  tne 
minimum  anq  maximum  rgnoes  tor  the  conventional  Cartesian 
coordinates.  Atter  dimensiorinq  the  screen  to  tre  desired 
size»  the  user  may  relv  ucon  the  sottwar®  suooort  cac<aae  to 
convert  any  set  qt  oocrqinates  that  are  valid  tor  that  criq 
system  into  the  orcner  real  screen  location,  (see  "conve" 
and  "convl"  in  Charter  xvl,  .Special  AopHcations  routines) 

C.  Virtual  Screen  Aocressino 

The  user  nas  no«  cetined  the  address  soace  tor  the  vir- 
tual screen,  and  mav  choose  the  ooint  t rom  which  the  oisclay 
should  Degin.  T n i s involves  tre  location  ot  the  Current 
Ooeratinq  Position  fCno).  The  CCP  is  initially  located  at 
the  lower  lett  corner  qt  the  semen.  This  is  the  case  atter 

r 0 u t i n e . 

bO 


every  c a 


to  t h ® 


5 C r o o rs 


A new  location  ter  tne 


COP  may 
Das  s i nq 
des i red 


be  establisheo  pv  using  frp  "strtxy"  routine 
as  carameters  tne  virtual  x,y  coordinates  of 
startino  Doint.  This  call  should  ce  of  t^>e  form 

strt*y(x»y); 


and 

the 


where  x and  y are  real  numbers.  The  C0°  is  modified  oy  most 
of  the  actual  disDlav  routines,  as  exolaineo  in  subsea uent 
Chaoters  of  this  manual.  Therefore  the  user  must  confirm  its 
location  orior  to  attemcri-'o  to  oisolav  anctrer  image. 


There  are  three  ^0005  of  aocressinc  tne  ?<i’'TEh.  screen  ; 
absolute/  relative/  a no  indexed. 

1.  Absolute  addressing  is  the  normal  or  default  mode. 
The  starting  ccint  (COP)  for  a oisolay  is  selected  bv 
use  of  the  "strtxy"  routine.  Tne  engino  COP  aeoenas  on 
the  current  control  mode  (Chao  Vll  “ XlV),  ang  t^e 
tyoe  of  disolav  that  is  generated. 

2.  Relative  addressing  is  onlv  acolicarle  to  the  cracn- 


ics  control 

modes . I f S only 

use 

is  throuah  the  routine 

called  "nointr".  Toe  real  nymoers  oassed 

a s 

oarameters 

in  "point"" 

are  summed  with 

the 

X a^o  y 

V a 1 

ues  df  tre 

last  COP  to 

derive  the  next 

COP  . 

This  a 1 

lows 

the  user 

to  generate 

Such  displays 

as 

a sequence 

of  vectors 

drawn  re  1 a t i 

ve  to  each  ether 

« w 

i t h 0 u t 

computing  the 

actual  scr“en  ccordinates  of 

a 1 1 

the  eng 

cr  i 

nts.  As  an 

e X amp  1 e / if 

the  CriP  was  'oca 

ted 

at  (10.0 

.10. 

0 ) ana  the 

user  issued 

the  c omm and 

no i n t P ( 5 . 0 

/-=i. 

0 ) ; 

the  new  COP 


ould  r-e  located  at  (15.0/5.0) 


If  the 


user  was  ooerating  in  th<?  Graonic  Vector  norJe/  the 
above  call  «oula  have  drawn  a vector  fron  virtual 
screen  ooint  (10.0»10.0)  to  ooiot  (15.0,5.0). 

5.  inoexed  adoressing  is  turned  on  and  otf  cy  use  of  the 
"inaex"  routine.  11  call  ot  the  fom 

innexCi ,x,y); 

where  i has  the  inteaer  value  1,  would  initiate  in- 
dexeo  addrossing.  All  subseauent  instructions  would  ce 
interoreted  «ith  resoect  to  the  x ano  v oaraneter 
values  in  that  call,  (his  address  naocino  is  ocne  oy 
sufTtina  anv  suhseauent  screen  address  with  these 
values  to  oetemine  a new  COP.  For  example,  it  the 
followinc  Subroutine  calls  were  issued 

index(l,2.0,^.0); 

Strtxy(5.0,  5.0)  ; 


the  COP  would  be 

located 

a f 

the  virtual  screen  cooroi- 

nates  (5. 0,5.0) 

. This 

address i no 

sc  nemo 

can 

a 

D 1 Oyed  in  any  c f 

t^e  control 

moons  . 

J noe X ed 

add  r 

e s s i n q 

is  terminated 

by  1 S su i 

r a 

anc  t ho  r 

i nne  X ( i , 

X , y ) 

call. 

with  the  oaramet 

9 r 1 h a V 1 

no 

a value 

of  zero. 

I n 

this 

case,  the  x and 

V oaramet 

e r s 

are  i ano  red  . 

D.  Control  ‘^caes  and  Flaos 

'^rocrar'Tiatic  control  ot  the  Gx.-lOO^  cisolav  device  in- 
volves selecting  one  o*  eight  control  nones.  Each  ot  these 
modes  is  attecten  cv  certain  control  flaas.  n seoarate 

chaoter  in  this  "Anual  is  devoted  to  each  of  the  control 

L L 


modes.  A aescription  cf  rh?  ^ive  control  ^laas  is  presented 
here . 


IX  - Indexed  Aodressinq 


The  effect  of  inoexed  adnressinq  is  explained  above  in 
Virtual  Screen  Aaoressinq,  alom  with  a discussion  of  its 
controllinq  routine  called  "index". 

8K  - reverse  sac^croun'i 


rthen  set/  this  causes  a "reverse  colaritv"  in  tne  color 
selection  orocess.  It  effectively  reverses  or  inverts  the 
current  color  tanle.  The  areas  of  tne  screen  that  were  being 
Shown  in  color  entry  0 (ncrrrfl)  nac^oround  color)  will  be  re“ 
verted  to  color  entry  15/  and  vice-versa.  (see  Chao  VI/ 
Color  Oisolays)  This  flag  is  turneo  on  and  off  bv  tne 
"Oxrna"  routine.  fre  flaa  would  be  turned  C''J  if  the  oara me- 
ter D was  diven  the  value  1 in  the  following  call  t 

Dxrndfb)  ; 

If  0 was  diven  a zero  value  the  ^laa  would  ce  turned  OFF, 

Art  - Additive  \rite 


<\hen  set/  the  generated  imaae  is  combined  with  the  imaoe 
already  being  crcjected  at  a oarticular  location.  This  may 
be  used  to  combine  characters  into  special  characters/ 
create  overlay  tyoe  oisolayS/  or  oisnlay  some  character 
close  to  another  i-naoe  without  destroying  a Portion  of  that 


image  with  the  seven  by  twelve  pixel  matrix  used  in  display- 


1 nq  alohanumeric  c^^aracters.  (see 


Chao 


VII 


Alphanumeric 


Mode)  The  control  of  this  f 1 aq  is  accomplished  Oy  the  "wri- 


ton" 

routine.  As 

be  fore » 

if  tne  s i nq 1 

e pa  r ame  t e r is 

a 1 

the 

f 1 ag 

is  turned 

on;  if 

it  is  0 the 

flao  is  turned 

off. 

The 

call  shoulq  aooear  as  follows  : 

w r i t o n ( w ) ? 

where  w reoresents  either  0 or  1.  (See  Appendi*  f*  for  error 
di aanost i c s ) 

D'fi  - D o u D 1 e /Moth 

i"(hen  set»  fhe  imace  Oeino  msolaved  is  acubled  in  width 
from  its  normal  size)  ie»  where  one  element  was  beina 
"oainteo"  two  consecutive  elements  on  that  line  are 
disolaved  in  tne  selected  color.  The  desireo  character  size 
(normal  or  double  width)  mav  be  selected  by  usinq  the  "size" 
oroceoure  as  follows  : 

s 1 ze ( s ) ; 

where  s is  either  I or  2 r reoresentinq  normal  or  double  wide 
respecfively.  (See  “Pcen‘lix  n for  error  diagnostics) 

FH  - Fixed  Point 

■fihen  setf  this  causes  th<»  (next)  established  COP  to  be- 
come  the  common  startinn  ooint  for  all  sunseouent  “nd  points 
issued  in  craphic  vector  and  clot  qeneraticn.  (see  the 
Chapters  on  oraphics  mooes)  Tro  fixed  ooint  flaa  is  turned 
on  and  off  bv  the  rcurine  named  "fixpr".  This  sinqle- 
oarameter  function  acc^ots  either  a zero  (to  turn  oft  tne 
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flag)  or  a one  Cro  turn  on  the  flaa).  Tne  call  i/^ould  be  of 
the  form  : 

f i X o t ( f ) ; 

where  f is  eitrer  0 or  1.  (See  Aooendix  B for  error  diagnos- 
tics) 

The  association  of  these  flaas  with  tne  different  modes 
is  shown  below  in  a listino  that  indicates  which  flags  are 
effective  in  each  mode,  ^ote  toe  number  assigned  to  each 
mode»  as  these  nu-cers  ar^  used  in  imrlernentimq  these  modes 
of  ooeration  on  tne 


c S 


f-^ode 


Control  FI aqs 


No . 

Name 

I K 

Eh 

AV, 

D.Y 

FP 

0 

A 1 p h a n U fr  e r i c 

vES 

YES 

YES 

YES 

NO 

1 

Transverse  Data 

YES 

YES 

YES 

YES 

NO 

2 

Raster  Data 

YES 

YES 

YES 

YES 

NO 

3 

Como  lex  Data 

YES 

YES 

NO 

YES 

NO 

a 

Graphic  Vector 

YES 

YFS 

1x0 

NO 

YES 

5 

G r aoh i c Plot 

YES 

YES 

NO 

1,0 

YES 

6 

Graohic  Cartesi 

an 

YES 

yES 

NO 

NO 

NO 

7 

G raoh  i c El  e'"en  r 

YF.  S 

YES 

NO 

NO 

NO 

Tne  control  ^cnes 

are  select  eri 

0 V 

use 

of  the  "setmooe" 

routine.  This  routine 

reauires  t«o 

oaranet 

e r S / 

the  f i 

rst  be- 

1 ng 

the  nurrher  tne 

des i red  none 

a s 

indicated 

anove 

. The 

secono  oaraTiefer  nust  oe  either 

0 

or  1 , 

If  z 

e r o is 

oa  s sed 

al  1 

control  Haas  are 

turned  off. 

I f 

one  i 

s oasseo  the  con- 

t ro  1 

flags  are  left  i 

n the  state 

the 

y ^ p r 

e i n 

prior 

to  this 

call.  Tne  call  is  o^  t 
where  a is  an  integer 

he  f 0 r n : 
set"-oc!e(arhO  ; 
va 1 ue  h - 7 and 

b 1 s 

either  0 

or  1 . 

(See  Acoeniiix  ^ ■for  error  aiaonostics) 


V 


VtCTCW  general  0AT4  table r INTERFACE 


The  Vector  General  oata  tablet  is  an  electronic  oevice 
which  allows  the  user  ro  sa'"c1e  the  coordinates  oT  its 
tablet“li'<e  surface  (aoorox  17"  by  17  "J.  The  tablet  is  lo- 
cated in  the  Laboratory  and  is  hosted  ov  the  "A"  side 
PDP-ll/bO  co""puter. 

This  taolet  is  interfaced  to  the  RA^’"TEh  software  sup- 
port routines  to  provide  the  user  with  a valuable  interac- 
tive tool.  To  effectivelv  utilise  the  data  tablets  the  user 
must  become  familiar  v.  ith  it's  operation.  The  fcllowina 
steps  will  facilitate  the  familiarization  process  : 

(11  Locate  tre  data  taolet  (for  assistance  see  the 

staff). 

(2)  f'ote  the  QN-OFF  switcn  located  on  the  box  con- 
nected to  the  tablet  surface.  To  use  tre  tablet 
the  Switch  must  oe  C^!;  when  not  in  use  the  Switch 
should  be  OFF. 

(3)  Locate  the  stylus  (a  pen-like  device  connected 
to  the  controller  bv  a wire).  On  the  stylus  there 
is  a plunger  tio  that  -av  ce  oecressea.  Toe 
depression  of  this  tio  is  sionificart  in  certain 
applications. 

(u)  Also  notice/  on  the  tablet  eoae/  that  thare 
are  two  lidhts.  One  lioht  ingicates  th^t  tne 


stylus  is  near  the  taclet  surface  ana  the  other 


inoicates  t^at  the  clunaer  is  cfepresseci. 

(5)  Turn  on  the  tablet  ana  witness  the  functions 
of  the  stylus  and  the  reactions  of  the  liqhts. 


The  data  tablet  interface  allows  the  user  to  interac- 
tively control  the  execution  seouence  of  his  orograri.  Tq 
effectively  utilize  this  tool,  the  user  snculc  be  aware  of 
what  t'^e  software  suocort  routines,  desionert  for  the  tablet, 
can  do  for  him.  There  are  seven  software  supcort  routines  of 


interest  to  tne  user.  4n  interactive  tutorial  program  is 
provided  for  the  user's  convenience.  I'his  program  exercises 
each  of  the  software  support  routines  to  cive  the  user  a 
feel  for  what  tnev  can  do.  To  use  the  tutorial  the  user 
tyoes(atoneofthe"A"side  terminals): 

L Q G I : c s 2 0 0 0 c / r 
•^ASSaQ^D:  student  c/r 

cd  ramtek  c/r 
vGfao.x  c/n 


This  sequence 

of  steps 

1 s 

tor  the 

user 

who  is  not 

a 1 - 

ready 

' ooged 

in  to 

u^'H.  If 

3 1 

r eaov  1 oa 

geo  i 

n , tne  user 

need 

only 

c h ange 

to  tne 

" r a m t e k " 

n i 

r ec  t 0 r V , 

then 

execute  the 

t u - 

torial  croaram.  This  wou'o  be  accomolisnea  bv  tycinq  ; 
Cd  /usr/cs20t)0/ramtex  c/r 
vgt ab.x  c/r 


In  either  case  th«=  result  will  oe  that  the  tutorial 
program  will  re  activateq.  It  exercises  eacn  of  tne  func- 


i 


t 


tional  rru^’ines  in  the  suroort  cac*<aoe.  Ijsers  are  encouracea 
to  “Halle  throunh"  this  session  prior  to  atte'rptinq  to  enoaoe 
the  seoarate  taolet  routines,  -^t  the  co. deletion  of  the  ses- 
sion the  UM)*  cronpt  (%)  will  apoear  on  the  terminal. 

f- o r reference  Purposes  ano  for  tne  user  who  only  needs 
to  be  refreshed  on  the  functions  of  the  tablet  succort 
routines  a crief  oescrioticn  ct  “ach  is  provided.  The  fol- 
lowing is  a synocsis  of  the  routir'es  included  in  the  cacoue 


(lltabinirC)  : Ccens  tre  ’■ablet  and  sets  the  -a*- 
i •’•urn  nu'hber  of  s «.  i t c h o s *■  o 

( 2 ) t aba  i •”  ( t X •ra  X » t X m i n , t v^a  X » t y i n J : Allows  t^e 

user  to  define  his  own  view  of  the  tablet  bv  stat- 
T •o  the  maxinum  and  -inimum  values  of  his  co- 


ordinate system. 

Ci)cetxy(n)  : returns  the  X and  y co-oroinates  of 
a point  on  the  tablet#  as  defined  bv  the  location 
of  the  stylus.  Tne  aroumen t "n"  allows  the  user  to 
select  wnefner  or  not  the  tic  neeo  be  ■*po~ess'=o 
(n=l  oen  mijst  be  deoressed#  n = 0 cen  not 


deoressed ) . 

(4) sixpa<()  : defines  and  allows 
standard  set  of  six  loaical 
tan1et.(=ee  temolarp  1 in  Lao) 

(5) cui  ldSw(Sw»xhi  ,xln,yhi  ,ylo)  1 
to  build  h,.;  Own  IcTical  Switch 
fined  by  f '' e users  ’•'Put 


selection  from  a 
Switches  on  the 

Allows  the  user 
at  a location  ge- 


1 

I 

)■ 

t 

i 


a n d 


assigns  the  users 


Switch  nomber  (sw)  to  it. 

(o)qetswf)  : hJeturns  the  number  of  the  valid  logi- 
cal switch  in  which  the  stylus  has  beer  decresseo 
or  a -1  if  invalid. 

(7)tabsw(ns)  : Allows  the  user  to  define  logical 
switches  via  the  tablet  itself  by  Dieting  the  low 
and  high  ooints  of  each  switch  with  the  stylus. 
The  number  of  switches  oesireci  is  indicated  by  the 
oarameter  "rs". 

For  more  soecific  information  on  these  suoDort  routines 
see  Aobendix  b. 
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VI 


COLOR  displays 


I 

j 


I 

I 

i 


The  RAMTEK  hardware  inoleTients  color  oy  comoining  redf 
blue  and  green  in  varying  intensities  to  oroduce  the  aesired 
color.  The  varying  i n t en s i t i t i e s are  stored  in  the  v i aeo 
Ioo>c-uo  teole  (VLT)  for  access  by  the  hardware.  The  GX-lOuA 
can  generate  lo  levels  of  intensity  for  each  of  the  three 
oasic  colors^  which  results  in  possible  oifferent  co"- 
oi  nations.  The  oossicility  of  oifferent  colors  does 
not  mean  that  the  user  has  all  aoPo  availaole  at  once!  The 
RAMfEK  software  allows  for  IS  color  tables  of  lb  color  en- 
tries each.  This  '^eans  that  the  user  nas  access  to  286 
colors.  The  GX-IOOA  can  access  only  one  fabler  with  lb  dis- 
tinct colorsr  at  any  given  time. 

For  clarity  the  hardware  video  loo<“uc  table  will  ne 
referred  to  as  toe  color  loo<~uo  taole.  The  haroware- 
accessiole  color  loo<-uo  table  can  store  sixteen  (lo) 
seoarate  colors.  This  constraint  is  one  that  the  user  should 
be  aware  of/  but  not  concerned  with,  as  the  software  support 
routines  allow  the  user  to  overcome  this  restriction  quite 
easily,  through  manipulation  of  the  tables. 


The 

s'c  f t wa  re 

that  orovides  the  color 

S < J o c 0 r t 

for  the 

RAMfEh  al 

lows  t n e 

user  to  : 

'J  t i 1 W ^ 

oreoefin,»d  colors. 
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Oe^ine  his  own  colors. 

Select  color  sets. 

Select  soec i f i c colors  within  a set. 

Interactive!/  nooifv  colors. 

Save  color  taoles. 

'Restore  color  tables. 

Text  and/or  graohics  nav  be  rlisola/ed  in  anv  oe+ineo 
color.  Tre  software  sunoort  a'llows  the  user  ro  define  vir- 
tually any  color  that  re  desires. 

A.  BASIC  USER  GUIOELI'lES 

The  RA'-FEk  software  ore!  o a vis  a set  of  color  taoles  for 
the  user.  These  tables  orovide  for  toe  color  needs  of  "rost 
Oeqinnina  to  intermediate  users. 

The  RAMTEk  suoDort  software  orovides  the  user  witr  a set 
of  tools  that  allow  him  ro  select  the  color  to  de  used  for 
disolav.  The  user  must  cause  the  aocrooriate  color  loo<-uo 
table  to  be  initializes  ano  tnen  rrvav  select  from  colors 
within  it.  The  initialization  of  a oarricular  color  table 
is  accomplished  bv  invowino  a sucnort  function  "colorf(n)". 
When  "colort(n)"  is  called  the  following  actions  ta<e  place; 

1.  Color  table  n is  loaded. 

?.  All  display  imaoea  on  the  screen  are  refreshed 

wJtn  the  new  colnp  set. 

3.  The  oacxoround  color  of  the  screen  is  set  to 

entry  zero  of  tn“  new  table. 


3 


Once  the  user*  has  losoec!  a particular  color  table 


he 


J 


has  sixteen  colors  availaole  for  display.  To  then  select  a 
color  from  t^e  tacle  to  be  used  for  oisplav*  the  system  sup- 
port function  ''color(n)"  is  utilize  a.  ''ll  images  displayed 
subsequently  i/^ill  be  oisolaved  in  color  "n"  of  the  current 
CO  1 or  t ab I e . 

Of  the  eiahteen  tables  established  by  the  s oft ^are»  nine 
are  filled  with  predefined  colors  and  nine  are  blanx.  four 
of  these  taoles  are  protected  from  user  modification  (0-3). 

These  protected  tables  may  ce  utilized  out  not  modified.  The 
nine  predefined  tables  provide  a Sufficiently  large  color 
selection  for  most  users)  however,  there  are  a total  of 
eighteen  (18)  color  tables  should  the  user  re au  f re  more  i 

i 

flexioilitv.  Ihe  nine  blank  tables  must  be  defined  or  filled 


by  the  user  if  he  desi 

res  to 

use 

them  ( see  the 

explanation 

in  Agvanced  Color  “'’e 

t hodS  ) . 

The 

colors  present 

in  the  nine 

predefined  color  taoles  are  1 

i s t e 

d pe 1 ow  : 

COLOR  TA^LE 

COLOR 

0 

shades 

o f 

G r o y 

1 

Shades 

o f 

0 1 ue 

shades 

0 f 

green 

3 

Shades 

o f 

red 

a 

mixed 

mi  X e 0 

c 

mixed 

1 

mixed 

c 

shades 

0 t 

y e 1 low 

7.4 


Tne  RAi-lTEiv  user  so'ft  ware  allows  tne  viewina 
taOle  in  the  svste"’.  Eor  the  user  to  look  at 
color  table  he  nee"!  only  issue  the  aoorooriate 
Two  different  tyces  of  nisolay  are  available 
ana  a brief  display.  Tne  brief  disolay  Tav  be 
the  System  function  ’’dsovcthlCn)";  the 
" d i s D ( n ) " . 


of  any  color 
a particular 
system  call. 
t an  expanded 
selected  by 
expanded  by 


The  brief  disdav  causes  color  table  "n"  to  be  displayed 
as  a column  of  boxes  in  the  in^iividua)  colors  of  color  table 
”n''.  The  exoanded  disolav  oives  tne  user  not  only  a column 
of  boxes/  nut  lines  and  aloha numerics  in  each  color/  as  well 
as  the  octal  code  that  achieves  that  color  combination. 


The  best  «ay  for  the  user  to  become  familiar  with  the 
concepts  and  support  functions  introduced  is  by  using  the". 
Three  executable  oroorams  rave  been  provided  for  the  users 
con  yen i enc®  . 

1.  ppnG/?4-‘>  1 


Tris  prodram  is  desinneu  to  demonstrate  the  brief 
color  table  display/  loadino  of  a color  table/  selectino  a 
particular  color  entry  from  a color  taole/  and  the  result  of 
a particular  color  selection.  Ire  oroaram  will  first 
display  color  table  seven  (7)  in  the  orief  format/  then  de- 
lay for  six  (o)  seconds  and  display  a box  in  color  four  of 
color  table  seven.  The  user  may  tyoe  the  oroaram  in  himself 
or  use  the  cs^OOO  file  whero  it  exists  in  noth  the  source 
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form  ana  an  executable  form 


a.  To  use  the  cs^'OOO  file  tyce  : 

LOf^IM;  cs^OOO  c/r 
PASoWUi^D:  stuaent  c/r 

ca  ramtei<  c/r 

b. To  list  the  onoqram: 

list  -c  ol.c  c/r 

c. To  execute  the  ornqram: 

c I . X c/r 

a.  For  the  user  xhg  nesires  to  inputf  comoile/  and  exe“ 
cute  the  oroaraT,  nimself  a Hstinq  of  the  source  coae 
is  c rc V i dea . 
m a 1 n ( ) 

(ramtekf);  //initialize  RA^TEK 

erasef);  /-'erase  the  screen 

dsry  c t c 1 ( ' ) ; //disdav  color  table  7 

colort(7);  //select  color  table  7 

color(J);  //select  entry  u 

sleeo(o);  //celav  h seconds 

oloc'<(''0.0»50.0»7^.0»?5.0);  //arav«  block 


> 

The  routine  "block"  «iitl  be  exolained  in  a later 
chapter;  it  should  nor  concern  rne  user  at  this  staae. 


2.  PWGGAA'*  2 


This  examole  is  desioneo  to  introduce  the  user  to 
the  expanded  format  for  msolayina  a color  taole  ana  the  ef- 


7h 


feet  on  the  screen  imaae  of  losaina  a new  color  table.  Par- 
ticularly the  exafTole  aisnlavs  color  taole  six  (b)  in  the 
expandeo  fomat/  delays  six  fo)  seconds  ano  then  loads  color 
table  five  (5).  The  user  should  note  that  when  the  new  color 
table  is  loaded  it  is  effectively  disolavedr  but  the  text 
still  indicates  that  it  is  color  table  six  (6),  This 
hidhlidhts  the  fact  that  all  of  the  information  displayed 
changes  color  but  the  information  itself  remains  unchanged. 

a.  To  use  cs2000: 

LOGIN:  CS2000  c/r 
PASSaOPO:  student  c/r 
cd  ramtek  c/r 

b. To  list  the  prooram: 

list  -c  p2.c 

c. To  execute  the  orooram: 

o2 . X c/r 

d.  To  input  the  orooram  the  following  listing  is  pro- 


V i ded 


ma i n ( ) 


ramtekC);  //initiali2e 


erasef)?  //erase  screen 


colort(h);  //load  color  table 


disoCb);  //display  color  taole  b 


sleeo(t));  //delay  for  o seconds 


colort(7);  //loa<j  new  color  table 


I 

i I 

J 
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5.  PROGRAM  5 


This  exafrole  is  desioned  to  emohasize  the  effect  of 
the  display  color  selection.  Color  table  seven(7)  will  oe 
loaded  tnen  a box  displayed  in  color  3 of  that  table.  A 
short  delay  will  occur,  tren  another  box  will  he  aisplayea 
in  color  four  (4)  of  tnat  table.  The  dsoyctbl  option  is  used 
to  allow  the  user  to  verify  the  results, 
a. To  use  cs2000; 

L 0 G 1 1.1 ; c s I?  0 0 0 c / r 
PASSa’QwD;  student  c/r 
C 0 rant  e c/r 
o.To  list  the  prodran: 
list  -c  o5.c  c/r 
c.To  execufe  tne  craqran; 
o 3 . X c/r 

a.  The  oroqran  listtnq  ^oMows; 
na i n ( ) 

TraTtexf);  //initialize  rartex 
colort(7);  //se’ect  color  taole  7 
ascyctol(7);  //display  color  table  7 
color(3);  //select  color  3 
/♦draw  box  in  color  3 */ 

Dloc'c(S0.h,7S.0,P'^. 0,5.0); 
sleeo(b);  //delay  6 sec 
coiorfy);  //select  color  4 

clock(65.0,b0.0,B(i.b,^0.0);  //draw  box  color  4 

} 


78 


The  user  shouM  now  he  capable  writing  programs 
that  utilize  oasic  color  manipulation  techniques.  There  are 
more  comolex  and  sco h i s t i c a t ed  options  that  are  covered  in 
the  next  sec  t i on . 


0. 

AOV  A 

MCED  COLOR  ‘'ETmOLS 

The 

basics  for  color  manipulation 

reou  1 

re 

1 i 1 1 1 

e e f T o r t 

on 

the 

part  of  the  user.  Since 

the 

mo  re 

advanced 

user  may 

need 

to 

solve  a more  complex  nron 

1 em  / 

t ^ e 

RA"tTEK 

software 

has 

oeen  oesiqned  tc  assist 

the 

user  and 

simp] 

i f y these 

sometimes  comclicated  tasks. 

The  higher  level  user-oriented  support  routines  are  pri- 
marily to  allow  the  user  to  modifv  existing  color  tables/ 
build  new  color  tables/  save  a qrouo  oT  color  tables*  ang 
restore  to  an  active  status  olg  color  tables. 

1.  '^UOIFrl.'.G  COLOR  TABLES 


The 

modi f i c a t 

ion  of  the  IF 

color 

tables  may 

be 

ac- 

c omp  1 

i Shea 

n y u t i 1 i 

^ino  the  data 

t ao 1 e t 

or  t ne  RA 

Vi  r E 

'<  e y - 

board 

. Each 

of  these 

t ec  hn i aues  w i 

11  be 

di scussed 

so 

that 

the  user  may  i nt e 1 1 i pent  1 v select  the  appropriate  one. 
a.  04TA  TABLET  ''ET'-nDS 

The  system  software  that  supports  data  tablet 
color  manipulation  is  compact  ang  tast;  this  will  be  an  ad- 
vantaoe  to  t^e  user  who  reouir«>s  on-line  color  table  manipu- 
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lation  . In  order  to  execute  t i s suooorf  cacxaqe  the  user 
issues  a call  of  tne  forr>  ; taOcolor();.  Fre  syste""  ^i11 
then  oronot  for  the  reauireo  inouts  to  alter  ano/or  build 
color  tables. 

The  user-cri“nted  routine  "taocolorC)"  offers 
one  of  two  ODtions  : builoina  an  entire  table  or  changing  an 
existing  table.  Tne  tablet  is  viewea  in  tnis  aoolication  as 
per  te'fclate  2.  in  the  Lab  . Once  in  execution  the  program  is 
tutorial  in  nature  ano  will  eromot  tne  user  for  reouireb  in- 
cuts. A sample  session  is  provided  to  familiarize  the  user 
witn  color  manipulation  via  tne  data  taolet. 


(1)  PkUGRAv.  a 


This  exercise  is  aesigned  to  familiarize 
the  user  with  tne  technioues  used  by  the  data  taclet  color 
manioulaticn  function. 

(l)To  use  the  cs2000  tile  type  : 

LjGi;«;  CJi(?000  c/n 
PjSSifQPO:  student 


Cd  ramte*  c/r 

(^)To  list  tne  source  code: 
list  -c  o«.c  c/r 
(i)To  execute  tie  orcoram: 

0 u . X c/r 

(‘iJP’or  tha  usen  «no  wishes  to  input  tne  source  code 
himself  a listing  is  oroviden.  Fnis  program  initial- 


“rases 


sc  r Pen 


calls 


izes  tre  t^A  'TF^ 


action  the  aata  taolet  colon  nanioulation  package 


k 


T a i n ( ) 

{rante<();  //initialize 
taoinitC);  //initialize  taolet 
erase()f  //erase  screen 

tahcolor();  //call  v.G,  taclet  routine 
erase  C ) i 
} 

0 . K £ Y 0 R 0 V £ r H 0 s 

Tne  Purpose  of  this  interactive  Drograo  is  to 
allow  the  user  to  see  ano  ngdifv  tne  color  1oo«-ud  tables 
while  seateo  at  tne  RA'-'TFk  kevPoaro  . This  extensive 
software  oackaae  is  very  large  and  should  not  oe  used  in- 
discrir'inately.  Tt  is  niohly  recoT'renoed  that  it  oe  used 
only  to  Duild  a set  of  color  tables*  tnen  save  these  tables 
to  be  loaded  into  the  us“rs  ormucrion  program'  at  a later 
time  (see  saving  color  tables). 

For  a complete  explanation  of  this  option  see 
the  oescripfion  of  interf)  in  aooendix  S,  If  the  user  is 
interested  in  utilizing  this  ootion  he  should  execute  tne 
following  oroararr  to  get  an  aooreciation  for  it's  cacafcili- 
t i es . 

fl)  PPOGRAiV  "3 

This  example  program  initializes  the  RA^'TEk 
and  calls  the  interactive  color  manipulation  routine. 


I 


I 

1 
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(aJ  lo  use  tne  cs2000  file  tyoe  : 


LOGIN;  cs^OOO  z/r 


PASSt-vOf^D:  student  c/r 


Cd  ra-nteK  c/r 


(b)To  list  the  orogra'Ti: 


list  “C  ob.c  c/r 


(c)To  execute  the  Drogra'n: 


o5  . X c/r 


(d)  Pro a ran  listing; 


na  i n ( ) 


{rante<();  //initialize 


eraseOJ  //erase  the  screen 


inter();  //call  color  nanio.  routine 


The  utilization  of  interC)  vice  taOcolorC) 


will  result  in  tne  user  orogranr>  being  hPUB  cvtes  larger.  The 


size  of  orograns  oeing  a consideration  in  software  desion 


imolies  that  interf)  should  i-e  used  selectively.  There  are 


soec  i f i c acolications  tnat  neguire  it's  use  ana  it  «ill  cer- 


form  well  in  these  acclications. 


c.  ’-'ANuAL  CCLCP  lhadimg 


n»  svster  crcvioes  for  the  user  t^e  capability 


load  a ra'"ticjlar  color  table  as  an  ar- 


-7.  ' - ’ \ j'ocess  Tc-e  cunbersono  ana  less 


r~lcr  -arioylai'icn  techniaues. 


-y  t~e  user  force's 


'4' 


him  to  preselect  colors  an-1  manually  provide  the  mechanism 
for  loading  , Out  in  small  unc omo 1 i c a t ed  applications  af- 
fords the  user'a  feasible  solution  to  his  immediate  problem, 

T no  orogram mafic  loading  of  a color  tacle  is  a 
two  step  process.  The  first  steo  in  the  process  is  to  con- 
struct an  array  in  his  program  that  defines  the  selected 
color  intensities.  This  definition  of  colors  is  accomplished 
by  first  declaring  an  arrav  gf  16  elements/  since  this  is 
the  number  of  elements  in  a color  tacle  . The  array  must 
then  be  given  the  appropriate  color  intensities  by  a system 
software  routine  call  to  tripleC)  fsee  hpoendix  P/  triclef)/ 
for  specifics).  Tne  triple  routine  returns  a coded  value 
that  represents  the  appropriate  color  mix.  Once  the  array 
has  the  aooropriate  coded  value  it  is  then  programmatically 
loaded  into  the  master  array  of  color  tables  by  calling  the 
system  routine  "c  I rtn  1 ( t / a ) ’’  (see  clrtbl/  ■icoenaix  S),  where 
”t”  is  the  numper  of  tne  color  table  to  be  replaced  ana  "a" 
is  the  name  of  fho  color  tacle  holding  the  codec  values. 

This  procedure  may  seem  complicaten  ano  is  prob- 
ably better  illustrated  by  an  examole.  The  user  is  en- 
courageO  to  “xecute  the  examrle  oroaram  to  experience  the 
process . 

(1)  PROGRAi'.'  6 


This 

o rcQ  ran 

fa^es  a certain 

nreae fined  set 

0 f 

color 

T i X e s ana 

CUT  las 

colcr  tacle  . 

Once  tne  co'or 

table  has  been  builtf  it  is  then  aisclayed  for  the  user  to 


view.  In  adaition  to  disolaving  the  color  table/  a set  of 
intersecting  lines  are  arawn  tnat  intersect  at  virtual 
screen  co-ordinates  (5. 0,5.0).  Tne  lines  are  drawn  in  color 
U of  color  table  9,  the  one  just  built. 

(a)  To  use  tne  cs200u  file  tyoe: 

LOGItl;  cs2000  c/r 
PA5S-'i09D;  stuaent  c/r 
c d ran' t e < c r 
Cb)To  list  the  orogra-^: 
list  -C  ob.c  c/r 
lc)To  execute  the  rrooram: 

DO . X c/r 

(d)  Prooran  listing: 

int  atlOl/  //declare  array 
na  i n ( ) 

ira^rte<()/  //  initialize  rantetf 
/*  set  color  intensities  into  array  */ 
a 1 0 } = t r i c 1 e f 1 5 , 1 5 / 1 5 ) / //white 
afll=tricle(15/O,0): 
a(21=triclef0/l5/0); 
aC31=tricle(0,0/15); 
a[A)=tricle(3/l'^/2); 
af5)=tricIe(d/l5/0); 
a[6)=tricle(h,0/0); 
a (71 =tricle(0,8/P); 
a(81=tricle(0/0/h); 
al9)=triole(8/6/0); 
a(10] =triole(0,«,8); 
arill=trio1e(*/')/^); 
a(l2l=triDle(lO,  10,10); 
a[l3]=triole(4,9/l); 
a[l'-*l=triole(5/0/'i); 
a(l5]=triole(’°,  1,  15); 
clrtbl(9,a);  //load  naster  array 
osovctcHP);  //disDlay  color  table  ^ 
colnrfiP);  color(^i);  //select  color 
screen(0. 0,0. 0,10. 0/10.0);  //dinension  screen 
ax  is(5. 0/5.0);  //draw  axis 
) 


ea 


1. 


The  user»  havina  now  executeo  the  suqaested 
sample  oPoqpams»  should  have  a oooo  anopeciation  for  how  to 
cpeate  ana  manioulate  colop  tables.  IT  mope  in-decth  infop- 
mation  is  pequiped»  the  usep  is  encounageo  to  peseapch 
Wefepences  1 and  3 Top  the  specific  hapdwape  and  suooopt 
design. 

2.  SAVIMG  COLOR  rapLES 

as  mentioned  eanliePr  the  systeT  color  taoles  aPe 
initialized  each  time  a usep  begins  a session.  These  colons 
may  oe  alteneo  py  the  methods  oescPibeo  aoove.  The  anility 
to  save  the  curnent  state  of  all  colon  tables  fon  use  at  a 
laten  time  not  only  enhances  the  users  caoaOilities  but  is 
an  absolute  must  for  oroduction  orograms  that  reouire  cer- 
tain color  sets.  The  user  will  certainly  aopreciate  the 
opoblem  if  he  considers  the  case  where  he  has  defined  a 
large  number  of  specific  color  sets  for  distinct  applica- 
tions using  "tabcolorC)"  ano/or  "intep()"f  and  has  no  way  to 
save  them,  //ithout  the  color  savino  option,  in  oroer  for  the 
user  to  continue  to  use  a specific  set  of  defineo  colors  in 
reoeateo  runs  of  the  same  program,  he  must  reconstruct  them 
each  time. 

In  utilizino  the  save  color  option  the  user  must  be 
aware  of  two  routines: 
sa VC  1 r ( ) ; 

r e sc  1 r ( ) ; 

The  routine  "savcIrC)"  saves  t^e  entire  color  arrav  in  a 


es 


B.  BASIC  USER  GUIDELINES 

As  mentioned  earlier  in  this  manualf  the  software  suo- 
port  oackaoe  for  the  RAMTEK  is  containea  within  the  UNIX 
file  system,  in  the  form  of  a library  of  subroutines  written 
in  the  'C'  orogramminq  lamuaqe.  These  routines  are  accessed 
(via  any  of  the  terminals  on  the  "A"  system)  by  ccmpilinq  a 
user-created  'C'  orogram  containing  references  to  functions 
that  reside  in  tnat  library.  scecial  snell  commana  for 

comoilinq  a crogram  t-haf  calls  routines  from  the  RA^'TEK  li- 
brary is  called  "ramte<"/  and  needs  only  be  passed  tne  name 
of  the  file  to  be  comnilec. 

Such  a command  would  be  ct  rhe  form  : 

ramfeic  filename. c 

(note  tnat  the  file  ^ust  be  of  tyoe  ".c") 

The  first  graphics  routine  that  must  be  calleo  from 
within  the  user's  crogram  is,  in  every  case,  the  one  that  is 
also  named  "ramtet<".  (this  should  not  ne  confused  wito 
shell  command  above)  This  routine  ooens  the  device,  erases 
the  screen,  ano  »starlishes  user  access  * o it.  T-'e  call 
should  acoear  as  follows  : 

ra-t  ek  f ) ; 

To  place  fhe  RA>'TFh  novice  in  the  aichanumeric  '^ode,  toe 
user  may  u*’ili?e  tre  "setmooe"  routine,  with  a call  of  the 
form  : 

s e t m 0 d e ( ' J , H ) J 

(Note  ! the  Alchanumeric  mooe  has  been  defined  to  be  mode 


"0";  trie  secona  carafreter  of  "0"  turns  of^  any  previously 
selectea  control  flaasJ  a "1"  in  tris  position  would 
preserve  these  flaas.) 

Although  some  oisclav  routines  will  automatically  set 
the  prooer  mooe»  it  is  gooo  practice  to  include  this  "set- 
mooe"  call  in  user  crcgrarrs. 

The  user  is  now  ready  to  select  the  area  on  the  screen 
in  which  he  cesires  alphanumeric  data  to  be  disolayel.  A 
Quick  review  o'^  the  iritiali?ina  "ra'^tekC  )"  routine  would 
reveal  that  the  virtual  screen  nas  oeen  dimensioned  to  100  X 
100,  ana  the  Current  Operating  (Jcsition  (COP)  is  locatea  in 
the  lower  lett  comer  (coordinates  0,0).  If  these  dimensions 
are  not  favorable,  the  user  select  his  own  with  a call 
to  the  "screen"  routine  of  the  fom  ; 

SCreen(xmin,y-Tiin,  xna*  ,vma*  ) > 
where  the  parameters  are  real  numcers. 


In  any 

case,  before  a 

call 

to  one  of  the 

display 

rout i ne  s , 

the  user  should 

C on  f i 

pm  r 0 

location  of 

t h w C QP 

(the  point 

at  which  th<»  displ 

lay  w 1 

II  D**Q  1 

n).  The  C'JP 

may  Ce 

re-es t ab 1 i sh ed  bv  a call  to 

Strtxy(x,y)J 

where  x and  v are  real  numbers  for  the  desired  virtual 
screen  coordinates. 

For  the  simple  application  of  displaying  a single  char- 
acter on  the  screen,  the  procedure  called  " I 1 1 r ( c h , s i ze  ) " is 

bP 


used.  The  cat!  is  of  the  for't'  : 


)ttr('x',size); 

where  the  character  lesireo  to  oe  output  is  enclosed  in  sin- 
qle  quotes  or  its  ASCII  cone  is  given  without  cuotes.  The 
size  is  oasseo  as  either  1 (nomai  size)  or  2 (Double 
wioth).  All  control  cits  or  flans  rerrain  as  previously  set. 
The  character  is  qisclayed  at  the  existing  COP.  No  line  feed 
occursf  nut  the  x-value  is  incre^enteo  cv  7 real  screen  ele- 
ments as  a result  of  the  cutout.  (The  COP  moves  to  the  right 
7 pixels.) 

Tne  -ost  s t r a 1 Dh  t - t 0 r <<a  r D approach  to  displaying  a set 
of  ASCII  characters/  such  as  a clcc<  of  text/  is  with  a call 
to  the  routine  ”te<fc"/  /<rich  renuires  b parameters/  in  orq- 
er,astollo.«s: 

1.  Ihe  aDoress  o^  an  array  of  pointers  to  the  text!  (re 
cointer  array  Shoulo  a \i  heen  oeclareo  as  pointers  to 
an  array  o*  vananle-lenoth  character  strings,  |he  ac- 
tual array  ot  character  strioas  shoulo  be  initializea 
fcllowino  tho  arrav  Declaration  ry  enclosing  «ach 
string  in  ooucle  OtiPteS  an,D  separating  them  by  commas. 
The  last  element  snoijlD  be  a zero/  witnout  Quotes, 
(see  examole  below) 

2.  The  number  of  the  oesirei  color  table  (an  integer 
value  t 4 - 17) 

3.  The  numoer  ot  the  oesireo  entry  from  that  color  table 

(inteoer  value  : 1 - 15) 
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An  inteaer  value  (1  or  2)  to  denote  desired  character 


t 

i size.  It  this  carameter  has  value  1 the  characters 

are  disolayed  in  normal  size;  it  it  has  value  the 

characters  are  cisolaved  in  douole  width  size. 

5.  An  inteaer  value  (0  or  1)  to  oisahle/enaole  the  aodi- 
tive  write  caoabilitv.  It  this  parameter  has  value  1» 
the  corresponding  text  will  be  written  "on  ton  ot" 
(ie»  in  adoiticn  to  --  not  in  replacement  ot)  the  ex~ 
isting  screen  image.  It  the  value  is  0»  the  desired 
text  will  rerlace  the  contents  ot  the  retresh  memory 
that  exists  at  t^e  soecitieo  locations. 

1.  PROGRA’'^  7 

The  execution  ot  this  proaram  «ill  aisolay  the  de- 
clared blocx  ot  text  in  double- width  character  size»  start- 
ing at  the  virtual  screen  coordinates  (cfS.  0,75.0).  The  char- 
acters will  ne  written  in  rre  color  specitied  cy  color  entry 
5 ot  color  taole  7,  and  will  reolace  any  data  previously 
written  mere. 

Tnis  prooram  would  normally  be  cnmnilec  using  the 
*C'  compiler  in  conjunction  with  the  system  library  ot  RAf*- 
TEK  subroutines,  via  ^.r\e  tollowino  command  : "ramte< 

tilename.c",  where  filename  is  the  name  ot  the  user  file 
containing  the  program.  However,  tt,is  example  is  availaole 
in  executable  t^rm  in  the  "cs^OOO  - ramtei<"  directory  on  the 
"A"  System,  (see  Chanter  II,  Goeratinq  Instructions) 
a.  To  use  the  cs^OOO  directory  ; 

R1 


LOGIN:  CS2000  c/r 


PASSW0f?0:  stucent  c/r 
ca  r3>nte<  c/r 

b.  To  list  tHe  proaram  : 

list  -c  o7.c  c/r 

c.  To  execute  the  oroqraT  : 

o7  . X c/r 

0.  The  listina  follows  : 


char  *txtlf  1 /*  declare  ara  initialize  the 

{"vvhat  you  see  "»  /*  pointer  array  ana  text 

" is  what  you  get  "/ 

'*  when  you  call 


TE  <70 


0 

1 ; 

int  ctabl  7;  /*  color  table  7 */ 

int  coll  ‘5;  /*  color  entry  5 */ 

int  szl  ?;  /♦  riouole  width  characters  */ 

intwol  0;  /*nowrite-Over*/ 

na  i n f ) 

Tramte<(  )J  /*  open  the  device  */ 

strtxy(?5. 0,75.0);  /*  set  starting  point  */ 

texto(txtl»ctarl,col  l,szl/wrl); 


I C.  AOVAi'CED  vFrnQns 

I 

After  a review  oT  "texto"  in  Appendix  3,  the  user  shcula 
realize  that  its  advantaoes  lie  in  si^olicity  and  generali- 
ty. In  orrjer  to  rerfom  more  complicated  alphanumeric 
! display  tasifS,  the  user  may  wish  to  proceed  to  a mere  de- 

j tailed  level  o^  operations. 

1 

1 

Further  analysis  oT  "texto"  would  reveal  that  it  actual- 
ly maices  a series  cT  calls  to  lower-level  routines.  Thoge 


I 


mmrnmmm 


routines  may*  of  course*  l~e  empl 

As  before*  tre  first  step  in 
insure  t^^at  the  system  is  in  th 
accomplishea  by  calling  the  rout 

set  morJe  ( a 

passina  a zero  value  to  paramete 
ceive  either  a 0 tc  turn  off 
leave  control  flags  as  presently 

Again*  if  the  user  v^ishes  to 
the  virtual  screen,  he  may  call 

screen! xmin,ymin 
and  Pass  the  minimum  ana  maximum 
dinate  system.  This  proceriure 
left  ccrner  ot  the  screen. 

In  oraer  to  select  a aesired 
user  may  call 

c o 1 o r t ( 

passing  the  number  of  the  table 
appropriate  display  color  entry 

CO  1 o r ( e 

where  e is  the  entry  numoer  ^ rom 

To  establish  a new  COP  for 
procedure 

strtxyCx 

is  utilized  with  the  starting  x 


P3 


oyed  individually. 

gisblaying  characters  is  to 
e Alphanumeric  mode.  This  is 
i ne 
, b ) ; 

r a.  Parameter  b must  re- 
all  control  flags*  or  a 1 to 
set. 

change  the  dimensions  cf 
the  procedure 
* xmax , ymax ) ; 

values  cf  the  aesirea  coor- 
leaves  the  CQP  at  the  lower 

working  color  table*  the 
t ) ; 

to  the  Parameter  t.  Tnen  the 
is  selected  by  a call  to 
) ; 

the  selected  table, 
a particular  display*  the 


* y ) ; 


and  t coordinates  (as  shown 


before)  beina  oassea  as  real  oarameters. 

The  size  of  the  characters  aisolayer)  ^nay  be  oroered  t>v  a 
call  to 

s i z e ( s ) ; 

with  s beino  either  1 or  2.  If  s is  passed  a value  of  1» 
the  characters  will  be  displayed  in  norrral  size?  if  a value 
of  2 is  oasseo/  they  i-«ill  be  oisolayed  in  double  width  size. 

The  selection  (or  deselection)  of  tre  'additive  write’ 
feature  (ie»  the  intention  to  'add  to’  rather  than  replace 
the  present  screen  i'^'ace)  is  relayed  to  the  system  oy  a cal  I 
t o 

w r i t o n ( w ) } 

with  w receiving  a 1 if  write-over  is  desired  or  a 0 if  not. 

The  actual  next-level  display  routine  that  is  called 
upon  by  "texto"  is  ’’ s t rou  r ( s ) ” . where  s is  a pointer  to  a 
single  strino  of  less  than  100  cnaracters.  For  example^  if 
the  user  had  the  following  declaration  in  nis  orogram  ; 

char  string!  ] ("Tr.  is  is  a string."}; 

then  a call  of  the  form 

strout(s’’rino}; 

would  display  that  sentence  on  the  screen.  It  should  be  not- 
ed here  that  after  a call  to  "strout"»  an  automatic  line 
feed/carriage  neturn  is  nerformeOf  lea  vino  the  CCF  on  the 
next  availanle  line  and  at  tre  same  element  position  as  tre 
previous  COP. 
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To  carry  this  discussion  one  steo  lower  in  the  struc- 
ture#  we  noint  out  that  "strout"  actually  counts  the  ngnber 
of  bytes  in  the  character  string  ana  passes  this  nu'T'der/ 
along  with  the  aoriress  o^  the  string,  to  the  routine 
"data(nane,lenath)".  This  routine  is  also  available  to  the 
user  if  he  is  certain  of  the  number  of  bytes  in  his  charac” 
ter  string  ana  does  not  atter>ct  f o pass  a string  that  is  too 
long.  As  an  example,  with  thp  same  "cnar  strina"  aeclaration 
as  above,  the  user  could  write 

data(strina,17); 

to  accomplish  t^e  same  task  as  "stroutCstringj;".  This 
routine  also  leaves  the  CUP  on  the  next  line  ana  same  ele- 
ment as  the  previous  CUP. 

After  some  error  checkina  and  setting  control  cits,  "aa~ 
ta"  goes  one  steo  lower  by  making  a system  call  to  the 
"OumD"  routine,  which  transmits  the  raw  oata  (accoroinq  to 
the  byte  count)  to  the  PAf»'TE‘<  instruction  buffer  for  in- 
terpretation ana  nisolay. 

By  similar  insnection,  we  fin  3 that  "size"  ac*’ually 
utilizes  a lower-level  routine  called  "dblwio"  to  s^t  the 
appropriate  control  bits  ang  "gump"  this  data  '’o  the  PflWTEK 
buffer. 

The  "dump”  routine  exisrs  at  about  the  lowest  level  of 
the  user  interface.  ^ c oirectly  utilize  this  routine,  the 
user  is  aovisen  to  oa’n  a greater  familiarity  with  the  "PA'-'- 
T E h G X - 1 u 0 P r 0 g r a m m i n g a u a 1 " 111. 
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This  saf^de  crognain  will  demonstrate  the  use  oT  tne 
alphanumeric  aisolay  routines  mentioned  above.  It  is  avail- 
able for  viewing  in  the  "cs2000  - r3mtei<"  Oirectory.  Its 
execution  will  result  in  t^e  declared  string  of  alohanumeric 
characters  being  disnlayed»  in  tan-iem,  at  three  stjccessive 
locations  on  the  screen,  ang  in  three  oifferenr  colors.  Mote 
that  the  second  oisolay  ca'l  in  each  instance  is  not  preced- 
ed by  a call  to  "strtxy".  This  demonstrates  the  location  of 
the  CUP  after  calling  either  o^  these  display  routines. 

a.  To  use  the  cs-^yOO  directory  : 

LGGIM:  c 32000  c/r 

P A S S d 0 R U : s t u o e n t c ''  r 

CO  ramtex  c/r 

b.  To  list  the  program  : 

list  -c  ob.c  c/r 

c.  fo  execute  the  program  : 

o8 . X c/r 

d.  The  listing  follows  :• 


Char  stringU  {"This  is  a string."!; 

//string  declaration 

ma  i n ( ) 

{ramtel<(l;  //  oren  the  device 

screen(0.0,y.0, 10.0, 10.0);  //dimension  screen 
color t (7);  //  select  color  table  7 

color(l);  //  select  color  1 
setmode(0,y);  //  select  alohanumeric  mooe 
size(2);  //  select  oounle-width  size 

strtxyCO. 5,0.0);  //set  starting  point  (CHP) 
strout(string);  //  disnlav  the  string 

da t a ( s t r i ng , 1 7 ) ; //  display  same  string 

sleeo(2);  //  cause  2 seconds 

color {U);  //  Change  color 


j 

] 
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strtnyC5.0»o.0);  //  chance  COP 
s r ou  t ( s t r i nc  ) ; //  repeat  oisp'av 

ca t a ( s t r t nn , 1 7 ) ; //  " " 

s ) eep  ( ) ; 

co1or(7);  //  change  color  again 

strtxv(5.5f3.0);  //  chanae  COP  again 

da t a ( s f r i ng , 1 7 } ; //  reoeat  aisolay 

s t rou t ( s t r i nc ) ; //  repeat  display 

} 

This  same  oisplay  could  be  achieved  by  the  following 
more  concise  program,  better  utilizing  some  of  the  features 
of  the  'C*  programT,  ing  language.  It  also  exists  in  execut- 
able form  in  the  "cs2000  - ramtex"  nirectorv  discussed  in 
Chapter  II. 


2.  PkOCPA'-'  o 

Note  the  initialisation  of  variables  in  declaration  state- 
ments, and  the  use  of  assignment  statements  and  expressions 
as  Parameters  in  the  procedure  cal's  for  "color"  ana 
"strtxy".  Once  again  : 

a.  To  use  the  cs?0O0  directory  : 

LUGIM;  CS2000  c/r 
P A S 5 '.'1 G P 0 ; s t u c e n r c/r 
CO  ramfeix  c/r 

р.  To  list  the  crcciram  : 

list  -C  r9.c  c/r 

с.  To  execute  tne  program  : 

p9  . X c/r 

d.  The  listing  follows  : 


Char  Strinnfl  ("This  is  a string."}; 

float  stx  -2.'i;  //  initialize  starting  X value 

float  sty  9.0;  //  " " Y 

me  i n ( ) 


r 
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{inti;  ( 

f ram  t e k ( ) ; I 

I screen(0.0/0.0/10.0»10,0)f  j 

setmocie(0»0);size(2);  l 

[ colort(7);  1 

I for(i-y;i^-^'’~’'*’^^  j 

; {co1or(itl3;  _ , 

! strtxyCCstx  = s t x + 2 . 5 ) f ( s t v ~ iJ)r  ^ 

[ strout(strina);  j 

data(strina,l7); 

j s 1 eeo ( 2 ) ; 

[ > i 
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TWA^SVEPSe  data  V.CDE 


This  mo'le  is  aesianpo  to  allow  the  user  to  cefine  ana 
draw  irregular  irnages  in  the  vertical  olane  (fl  elenents 
wide)  of  the  RAMTE^.  These  figures  snould  be  in  a single 
color,  as  the  facility  for  cnanoing  colors  wnile  orocessing 
an  image  aoes  not  e*ist  wnile  in  the  transverse  data  moce. 

The  user  ""ust  gain  a suoerficial  unoe  r s t a^o  i ng  of  now 
the  RA|v.TEh  processes  his  data  in  this  mode  to  oe  able  to 
use  the  mode  effectively.  The  bit  cattern  cf  a set  of  user 
defined  data  words  (bvtes)  describes  the  image  to  be 
displayed.  The  user  will  define  data  words  or  oytes,  recaro- 
less  of  which  he  chooses,  the  PAyTEK  interprets  the  data 
byte  by  byte  (a  oyte  consists  of  eight  bits).  The  bit  pat- 
tern of  each  Dvte  turns  hU'.  or  OFF  individual  pixels  on  the 
RAyiEK  screen. 

An  octal  numoer  ir,  the  C programming  lanauage  13)  is 
denoted  by  a leading  zero.  The  octal  form  of  numbers  will  be 
used  exclusively  in  rreoarino  transverse  data,  since  it  is 
simpler.  If  the  user  was  to  define  the  data  woro  "x"  as  "x 
= 0l5(j2if  (x  is  of  tyoe  intecer)  then  it's  bit  bv  bit 
representation  for  the  system  wou'd  be;  uOOllOlOOOOlO'JlO, 
The  RwyTEK  would  further  decompose  tnis  wora  into  two  data 
bytes  (OOOll'JlO  and  QOOIOOIC).  Tho  oata  bytes  are  tnen  rro- 

oq 


cessed  ov  the  RAMTEK  seauentiaHv/  beginning  at  the  user  ge- 


fined  starting  ooinf  (see  "strt*v").  The  eight  ctxels  to  tne 
right  of  this  ooint  are  intercreteo  as  either  CK  or  OFF 
deoengina  on  the  valije  of  it's  corresDonding  bit  in  the  data 
byte.  A one  indicates  that  the  oixe1  is  to  be  turned  ON; 
zero  indicates  the  OFF  state.  Each  consecutive  byte  is  then 
written  innediately  helow  the  last  one  until  all  are  oro” 
cessed  (see  "data"). 


A.  BASIC  USfcR  GUIDELIMES 

T«*o  very  likely  acolications  for  the  transverse  data 
•node  are  definition  ana  Jisolav  of  soecial  synfcols  and  ir- 
regular vertical  images.  Software  sucoort  routines  are  pro- 
vided to  allow  tne  user  to  perform  these  actions. 

1.  special  Sy^'BCLS 

A common  use  of  the  transverse  data  mode  would  be  to 
define  special  symbols  that  are  not  provided  in  the  stan- 
dard character  set.  For  example.  tne  user  may  oesire  to 
display  the  lowercase  Greek  letter  alpha,  by  defining  this 
letter  in  a linear  array  of  lemath  six  (woros).  and  calHnq 
the  system  suroort  function  "symbol (sy)"»  where  "sy"  is  the 
array  name,  the  user  may  oisolay  this  special  sympol  Quite 
eas 1 1 y . 

To  define  a special  character  tne  user  should  first 
draw  a matrix  (A  py  12)  and  develop  a gracnical  reoresenta- 

1 uu 
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tior  ot  ter 


F-cr  tie,  the  iCwercdSe  C»reek  al 


pria  «oul'T  ne: 
b V 1 1 


The  ■•^ext  steo  for  the  user  KOuln  t'e  to  transtorir  •■'•s 
graphic  rerjresentation  into  a data  reoresentation  T'a' 
he  utili?ed  cy  the  support  cackace.  Transforming  t^e  nr^r-  - 
cal  repres“ritation  of  the  lowercase  Greek  alpha  into  a «•- 
aole  data  r eo r es en t a t i on  is  accomplisheo  as  follows: 

a. Transform  the  graphical  view  into  the  cin^ry 
rep  re  sen  r a t i on  . 

(-  represents  a Dtank  ! * a rtotJ 


MYTt  GhAphIC  rr.  ARY 

1 - - — - --  - OuOOOOO'’' 

^ --------  OOOOOOuO 

i OOOOOOuO 

a OUlOui.lu 

5 OlulUluO 

h lUOOlhuo 

I U I 0 1 0 1 0 1' 

M --*---*-  (U)  I .)  0 •'  1 


q 


0 0 0 0 0 0 0 0 


1 


10  ooooooon 

11  00  0 0 0000 

12  00000  0 00 


b,  '^arry  oains  of  bytes  into  wonos.  Tris  is  done 
seauentially  frorr  the  oeginning. 


BYTES 

BI'IAOy  NlJh'ftER 

1 

and 

2 

000000  c 0 0 0 y n 0 0 0 0 

3 

and 

a 

0 0 0 0 0 0 0 0 0 0 1 0 0 0 1 0 

S 

and 

6 

u 1 0 1 0 1 0 0 1 0 0 0 1 0 0 0 

7 

and 

6 

0 1 0 1 0 1 0 0 0 0 1 0 0 0 1 0 

9 

ana 

1 0 

G n 0 0 0 0 0 0 0 0 0 0 u o o o 

1 1 

and 

12 

0 0 0 0 0 0 0 0 n 0 0 0 c 0 0 0 

These  six  v«ordS/  recresented  in  their  cinary  number 
form,  provide  the  most  basic  data  form  of  the  lowercase 
Greek  aloha. 

C.  Transform  the  binary  r ec r e S en t a t i on  3 info  octal 
numbers  for  processing.  T n i s oinary  to  octal  transfor- 
mation is  done  from  right  to  le^t.  Each  cinary  word  ’s 
divided  into  S grouos  of  three  binary  oiaits,  with  one 
binary  digit  left  over.  The  position  of  the  ones  in 
tnese  groucincs  represent  powers  of  t^e  numrer  two.  Top 
leftmost  didit  recresenfs  two  sauareg  when  a one  is  in 
this  locafion.  The  c®nt-er  aicit  , when  cne>  represents 
two  to  the  tirst  oower.  The  rightmost  digit  represents 
a one  (two  to  the  zero  cower).  Sum  the  numbers  in  each 
group  of  three  to  yield  one  octal  oimt. 


i 


J 
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1 0 2 


Ex: 

OlOlOlOOOOl 00010 
0 101  010  000  100  QIC 

0 5 ^ 0 ? 

Thus  the  octal  reoresenta'’ion  wouln  be:  0 0 5«'0^2. 
a.  An  octal  wora»  as  previously  stated^  is  oenoteo  by  a 
leading  zero.  The  followina  six  octal  numbers  reoresent 
the  lowercase  Greek  alpha  oescrineo  aoove: 

0000000 
0 0 0 0 0 a 2 
0052210 
00520^:2 
0000000 
0 0 0 0 0 C 0 

dow  that  t^'e  user  has  an  octal  nurrner  to  oefine  the 
special  sv^rol/  he  mav  Generate  that  symbol  by  calling  tre 
system  siicoort  routine  "symcolCsv)"»  «rere  "sv"  is  t^e  name 
of  ttie  user  oetined  arrav  containing  the  octal  oefinition  of 
the  symbol.  The  user  sroulo  verify  that  the  octal  cooe  list- 
ert  above  is  correct. 

a.  PPnCPAM  10 
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(l)To  use  csifOOO  tyne: 


LCiGIiM:  cSdOOO  c/r 

PASS  0^0!  student  c/r 

cd  ramtek  c/r 

(2) To  list  the  orogram; 

list  “C  nlO.c  c/r 

(3) To  execute  tne  croararp: 

D 1 0 . X c/r 

(JJProaran  Listino: 

/♦declare  array*/ 

int  alonalbJ  {0000000, 00 000l2» 
0052210, 0052042, 
0000000,0000000}; 

T’  a i o ( ) 

(ra'^tekC);  //initialize 
St rt X V (50 . 0 , 50 . 0 J ; //set  CQP 
colort(7};  //select  color  tacle 
color(2);  //color  2 
s y nb o 1 ( a 1 D r a ) ; //outcut  aloha 
aolwidCt);  //set  oouble  \«iath 
Strtxv(5 0.0, 30.0);  //estaclish  COP 
svfTDo  1 (aloha)  » 

> 

2.  IRREGULAR  vertical  I'-'ACES 


It  is  ouite  olausirle  to  consiner  tre  use  o*  the 
transverse  data  "node  to  oetine  irreoular  irraqes.  The  systeti 
software  suooorts  the  desion  anc  disolay  of  columns  of  in- 
formation via  the  function  "tcata(tDrr,by»ex,lv)",  where 
"totr"  is  the  name  of  the  array  (oointer),  "ov"  is  the 
numoer  of  bytes  to  oe  oufoutr  "ex"  is  the  cesireo  starting  x 
vaiue»  and  "ly"  is  the  desireo  starting  y value. 

Tne  user  might  desire  to  neveloc  a set  of  oversized 
carentheses  for  a soecial  aooMcation.  Inis  is  accomcHshed 

1 04 


by  first  aefinino  the  iTiao®  as 


niscusseb  in  the  orevious 


section,  then  via  "roata"  creatinq  the  oisolav.  Sucoos®  that 
the  user  has  aefineo  his  virhoal  screen  to  be  100  by  luO, 
with  (0,0)  in  the  lower  left  corner.  Perhaps  he  has  use  for 
a set  of  parentheses  that  encoTipass  of  the  screen  or, 

more  specifically,  r®al  screen  lines  C . * ?^0  = ug).  He 

must  then  define  bytes  Per  imaqe  ro  accomplish  this  tas''. 

The  definition  of  the  oata  is  as  aiscussen  previously. 

a.  PPGGOi"  11 

This  procram  shows  t *- o user  the  definition  of  a 
set  of  parentheses,  as  discussed  apove,  ano  how  to  create 
the  images  on  tne  screen  of  the  ^'l''TEK. 

(l)Tc  use  cs^OOO  tvoe: 

LG  Git;:  cs200  0 c/r 
PAoS'-'-'ORD:  student  c/r 
caramteKC/r 
(P)To  list  the  program: 
list  -c  pM.c  c/r 
(3)To  execute  the  prodram: 

D 1 1 . X c/r 

(A)Prooram  iistino: 

i n r 1 c a r en  ( p 0 ] { 0 C 0 0 '4  C 1 , 0 0 ('  0 A 0 3 , ■)  0 0 1 1 L/  3 , 

0 c 3 f’  V o , 0 ij  0 3 0 1 A , 0 0 ')  6 0 1 A , 

0 0 1 A n 3 0 , 0 0 1 A 0 b h , 0 0 3 0 0 0 0 , 

0 i)  b 0 1 A 0 , 0 0 0 0 3 0 0 , 0 1 A 0 3 0 t) , 

h 1 A 0 3 0 0 , n 1 A Ij  1 A A , 0 0 n 0 1 A 0 , 

0 0 3 0 0 b 0 , 0 0 3 0 A 3 C' , u 0 1 A 0 3 0 , 

0 0 0 b 0 1 A , 0 0 '■)  b 0 0 b , 0 0 h 3 I)  0 b , 

0 0 n 1 A 0 3 , 0 0 0 1 A 0 I , 0 (j  Q 0 A n I } ; 
int  rparenfPA]  <Ol0(ic0<',niO{j5u0,olA0  30u, 

0 0 b y 1 A 0 , 0 0 b 0 ' I b P , 0 ()  3 h i,i  b 0 , 
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0 0 1 a 0 3 0 , 0 0 1 a u 1 a , 0 0 0 o 0 1'4 , 

0 0 n 3 0 0 b , 0 0 0 3 0 0 3 , 0 0 0 1 u 0 5 , 

0 0 0 1 u 0 3 , 0 0 (H  a 0 o , 0 0 0 3 0 0 b , 

00  060  1 a, OOO0O30 , 00 1 a030, 

0 0 3 0 0 b 0 , 0 0 3 0 1 a 0 , 0 0 o 0 1 a 0 , 

0 1 « u 3 C'  0 , 0 m 0 2 0 u , 0 1 0 0 2 0 0 } ; 

m a 1 n ( ) 

(ramtekC);  //initialize 
colont(7);  co'or(?);  //colons 
trtataC  loaren,446»00. 0,60.0;  ! //ouncut 
trtataC  roaren,  06,6  0.0, 60.0)  ,'  //outout 
} 

The  function  "taata"  allows  nhe  user  to  raint 
portions  •'or  all)  of  the  screen  oy  aojustinq  to  the  next 
column  wren  screen  overflow  occurs.  The  user  neeo  not  «crry 
aoout  ooinq  off  tre  ccftcn  o f tne  screen. 


h.  PROGPii’-’.  1? 


This  proarafr  sro~s  the  reset  action  of  tre  func- 
tion "taata".  Data  is  oasseo  to  the  routine  tnat  is  much  toe 
1 onq  to  be  oisplaveo  in  a sinale  column,  thus  it  oaints  to 
the  richt.  The  imace  crawn  is  a do^’tec  line. 

(1) Tc  use  cs2000  tyre: 

LOGIf';  cs^OOO  c / '• 

PASS/' ('PD;  St  U Cl  not  c/r 
CO  ra.Ttex  c/r 

(2) To  list  the  program; 

list  -c  PI.P.C  c/r 

(3) To  execute  the  prooran: 

o 1 ? . X c/r 

(J)Proaram  'istina; 

int  testf3ool  ; 
n a 1 n ( ) 

iint  i;  ram  reK(),‘  //initialize 


1 Ob 


/♦initialize  array*/ 
for(i=o;i<30'JJi+*) 
t es  t [ i 1 = 0 1; 

color t(7J;  CO'or(2);  //colors 
rdataC  test  »t>00,  10,0»y0.0)  ; 

} 

The  user  shoulo  now  oossess  tne  skills  reouireo 
for  processira  me  vast  oainrify  of  ois  transverse  oata  ap- 
plications. The  next  sectioo  /<ill  oiscuss  sooe  of  t*'e 
specifics  of  the  oooe  for  none  aOvanceci  applications. 

6.  JO'/aTjCEO  '-EThODS 

The  user  who  opsires  to  execute  sc^-e  crocess  t^at  re- 
auires  nore  flexibility  inan  orovioeo  in  the  previous  sec- 
tion will  have  to  prop  ao«n  one  level  in  the  support  package 
to  the  more  fundament-al  functions  hor  processinc  transverse 
data.  The  oost  fund a cental  function  in  the  suonort  oacxaae/ 
in  relation  to  transverse  oaha»  is  "data(narr.e,bytes)".  Tre 
"data"  rouhine  sioolv  senos  raw  data  to  the  PA-TEK  fron  fhe 
arrav  "name"  for  the  specified  numrer  of  "bytes". 

The  user  oust/  at  this  level  / oe  responsible  '^or  setting 
the  mode  (see  "seroQi-ip"),  establishino  the  current  operating 
point  (see"strtxy")/  ana  providmo  his  own  oroarammatic  con- 
trol. The  data  definition  process  is  tho  same  as  discussed 
in  the  oASIC  LioEP  GUICELll'iEh  section. 

The  control  flaps  that  are  applicable  in  the  transverse 
data  mcae  are: 


It-OExED  Af.DPtSSIi.r, 


REVERSE  biCKGRUiJlsD 


ADuIIIVE  aHITE 
DOUBLE  /ilOTH 


The  user  must  select  all  of  his  fl 
mechanism  for  their  i mo  1 emen r a t i on  . 
data  applications  reouire  much  attenti 
cess.  For  more  specifics  the  user  i 
the  PA'“’TEh  Prooramminc  >’anual  ni»  in 


ags  ana  croviae  the 
Comclicated  transverse 
on  to  detail  for  suc- 
s encouraqeo  to  peruse 
the  Lab. 


i 


I 


1 


1 


m 


i 


1 o^> 


flags  are  saved;  if  ^ero  (C)/  then  all  flags  are  reset  to 


the  default  values. 

The  user  who  is  unfamiliar  with  the  oeneration  of  the 
octal  data  codes  that  define  an  image  should  review  the  sec- 
tion on  Transverse  oata.  The  octal  data  form  is  recommenoed 
for  it's  simplicity. 

The  software  surcort  function  "data"  is  used  to  tran- 
sport the  raw  aata  tc  the  SiMTEh  for  display,  a call  of  tre 
form 

ca  t a ( X » V ) ; 

causes  "y"  bytes  of  data  to  be  passed  to  the  RAWTEK  from  ar- 
ray " X *'  . 

The  tollowino  sample  program  is  provided  tc  assist  the 
user  in  developing  his  expertise  in  the'  use  of  the  Raster 
data  mode: 

A.  PHOGRA'v  15 


This 

program  is 

oes i dneo  to 

show  t 

he  user 

a specif 

i c 

use 

of  the 

Raster  data 

mode . The 

P r 0 d r am 

draws 

a set  of 

i n t 

e r- 

sec  t i na  ! 

lines  much  1 

ike  a arid 

system 

or  da  t 

a record 

• 

T h e 

ve  r s a t 1 1 1 

i t V of  the 

Raster  data  mpoe 

is  on  1 

y restricted 

Py 

the  users  imaqinarien. 

1.  To  use  csc’h'jO  tyre: 


I LUGli':cs£i'OOc/r 

[ PA3S.'.fjRD:stuoen^C/r 


m 


r 


ca  ramtek  c/r 

d.To  Hst  the  oroaram: 

list  - c c I 5 . c 

5.rc  execute  tne  orograrr; 

D 1 3 . X c / r 

Proaram  Listing  : 

Define  a horizontal  line  */ 
ln(18]  {0177777,0177777,0177777,0177777,0177777, 

0177777,0177777,0177777,0177777,0177777, 
0177777,0177777,0177777,0177777,0177777, 
0177777,0177777,0177777}; 

/♦Define  vertical  seoTents*/ 

divClOl  {01^0003, 03, 03,  3, 03, 03,  0 3, 0 3, 03, 03,  u 3, 0 3, 
03,03,03,03,03,03}; 

na i n ( ) 

{int  i,j;  float  sx,sy;  //oeclare  variables 
sx  = IbO.o;  sv  = lb  0.0; 
rarrtek();  //initialize  systerr 
coIort(7);  //establish  color  table 
se  t "rode  ( 5 , 0 ) ; //establish  raster  node 
col  or  ( c! ) ! //select  color 

screen! 0,0,0.0,t>a0.n,2a0.0);  //oi"iension  screen 
/ * 

OUTSIDE  LOOP  COMPCL 

* / 

for(j=0;j<i2;j++) 

{ S t r t X y ( s X , s v ) ; //establish  start  ocint 

aata(ln,3b); 

/♦^^I3IDE  LOOP  */ 
for(i=G;i<l8;i++l 

{aata(civ,5t)  / / sena  nata 
s v = s y - 1 ; 

} 

s y = s y + 1 ; 

} 

0 a t a ( 1 n , 3 b ) ; 

} 

The  user  should  now  oossess  the  reauirea  skills  to 
ieveloc  his  Own  soecial  i-"aoes  as  reouireo.  For  further  in- 
formation on  this  node  the  user  is  encouraged  to  read  the 
RAMlFh  ProcramT’ers  '•'anual  (11  in  the  Lab. 
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CON'PLEX  DATA  i'^OOE 


This  mode  writes  data  to  the  PA?-^TEK  screen  in  the  same 
manner  as  the  Paster  data  moae»  exceot  trat  it  allows  tne 
user  to  deHne  the  color  of  each  oixel  as  it  is  oainted. 
This  third  oimension  of  color  does  have  some  overhead  asso- 
ciated with  it»  in  that  now  the  user  must  define  the  color. 
The  color  definition  reauires  four  (4)  bits  oer  pixel  vice 
one  Cl)  bit  oer  pixel  in  the  other  two  oata  modes.  Tne  im- 
pact on  tne  user  is  that  where  one  oata  wcro  describes  six- 
teen (16)  oixels  in  either  Raster  or  Transverse  oata/  it 
only  aescribes  four  (4)  pixels  in  the  Complex  data  mode. 

The  obvious  benefit  of  this  mode  is  that  the  color  of 


i mages 

may  be  modi 

f i ed 

on  a pi 

X e 1 by 

oixel  c a s i 

s . 

The  four 

Pits  reauired  to  define 

a color 

allow 

the  user 

t 0 

address 

any  one  of  fifteen 

(15) 

colors 

in  the 

current  co 

1 0 r 

1 CO  lx  -UP 

t ao 1 e . 

The  user  my3t 

cor. 

St  rue  t 

his  data  woros 

now  using 

Pi  nary 

coded  decimal 

as 

an  added 

s t eo 

prior  to  CO 

p V e 

r t i nq  to 

octal  . 

The  color  definition  of  each  oixe'  must  oe  done  bv  t^e 
user,  then  passed  to  tne  software  support  o r od r amma t i c a 1 1 v . 
This  color  definition  reauires  the  use  of  4-cit  oinary 
groups  (called  ninary  cnceo  decimal).  These  groups  are  com- 
bined info  lo-nit  rinary  patterns,  then  converted  (ov  3-bit 


1 1? 


arouDs}  to  octal.  Suocose  the  user  wishes  to  define  a word 
that  selects  four  (U)  oixels  and  colors  then  accorainc  to 
the  colors  oner  four, se 'yen  ana  eleven  of  the  current  color 
look'UD  taole.  To  acco’rolish  this  task  he  ^rust  convert  the 
desired  color  entries  to  binary  codeo  decirial 

form  as  shown  oelowl 

DECIVAl  CUDED  OECI'^AL 

1 0 0 0 1 

'4  0 1 U 0 

7 0 111 

11  1011 

The  bsnarv  cooeo  oecimal  numoers  are  then  comoined  into  one 
binary  worn.  For  the  anove  exa'^ole  this  nijmoer  would  be: 

0001010001111011 

This  Binary  number  must  then  be  transfomeo  into  an  octal 
reoresentation  as  discussen  in  tho  chanter  on  Transverse  da- 
ta. The  octal  r eo r e s e n t a t 1 on  for  this  examole  wou'o  be 
001c?17  5.  The  user  must  cerform  this  data  transformation  him- 
self. 

Once  the  data  worns  are  oronerly  defineo>  the  user  neen 
only  olace  the  RA^TEh  in  the  Comolex  mode  with  a call  of  the 
form 

setmo^teT3»f); 

where  "f"  determines  if  oreyious  control  flans  are  to  ne 
saved  or  oestroyen  (f=l  save  ; f=0  destroy).  Having  esta- 
blished the  -ode  of  oceration  the  information  is  now  oasseg 
to  the  KAimTEh  -ith  a call  of  the  form 


3 


da  t 3 ( X » ; 

which  causes  "n"  tavtes  raw  nata  to  Ce  oasseo  to  the  Pu^- 
TEK  from  the  array  "x". 


The  foMowino  control  flaos  are  aonlicable  while 
operatinq  in  the  Comclex  mode: 
irjDExEO  ADDPESSIi'.G 
PEVEhSE  bAC'^GPOUi'vD 
double. 'ilCTH 


The  folio wine  samcle  crocram  is  provided  to  assist  the 
user  in  oevelooirq  expertise  in  the  use  of  the  Complex  data 
mode : 


A.  PROURA’x  1« 


This  crooram  is  oesioned  to  demonstrate  the  Complex  data 
mode.  Its  execution  causes  the  entire  display  screen  to  oe 
painted  with  alternatino  bands  of  tne  first  seven  colors  in 
colon  tablo  seven.  Tie  screen  is  then  oartially  eraseo  ana  a 
triangle  with  similar  creoerties  is  displaveo. 

1.  To  use  cs.^010  type: 

LQGI'M:  cs<?000  c/h 
PASSviORDt  student  c/r 
Cd  ramtex  c/r 
^.lo  list  pro dram: 

list  -C  ol-i.c  c/r 


i.To  execute  nrooram; 


ol^.x  c/r 


y.  Proa  raw  Hstinq 


int  ICloll;  //oeclare  array 
ma  i n ( ) 

{int  ifj»K?  float  sx/SVt 
ramtekC);  //init  systew 
se t mode ( 3 » 0 ) ; //estaolisn  wooe 
/♦IMITiaLlZE  ARP4Y  1 */ 
f or  ( i =0  ; i < 1 0 1 ; i = i 1^) 

{1  [i  1 =1  ti  >n  =007  S5b7; 

1 ( i +2) =1 [ i +5) +00fr3iyo; 
t (i+y]=l  li+Sl=() 052525; 

1 [itb)=1  [i+7]  = 0 0 0210  0; 

] ti  ♦51 =t  ( i +01  =003  lOo3; 

1 [i+ini=i [1*111=0021002; 

I l i * 1 21 = 1 (i  + 1 5] =00 1 0o2  I ; 

1 

screen! O.O/O.OfbO 0.0/200. 01;  //oinension  screen 
colort(7);  //select  color  table 
k = 320;  sx  = 0.0;  sy  = 0.0; 

/ * 

PAINT  SCPEF.N 
* / 

for(i=0;i<2‘4  0;i++) 

{strtxy(sx,syl  ; 
da  t a ( 1 » k ) ; 
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Graphic  vectup  ■-'cde 


A.  INTr^ODUCT  lUN 

The  Graohic  Vector  Moae  is  useri  opimarily  to  draw  lines 
or  vectors  oetween  user-detinert  end  ooints.  It  is  relative- 
ly sinole  to  use  and/  oy  its  nature/  fits  i^anv  acolications. 
The  user  must  fce  aware  tnat  exceot  in  vertical  or  horizontal 
lines/  a noticeable  Quantization  error  or  "stair-casinn"  ef- 
fect will  aocear.  This  connition  is  caused  by  the  low  line 
resolution  aodressable)  versus  hiqh  element  resolution 

(6U0)  of  the  system,  and  by  the  very  nature  of  the  raster 
scan  device. 

13.  BASIC  USER  GUIDELl>iES 

To  cut  the  RA.'lTEK  oevice  into  this  mode  requires  a call 
oftheform 

setr-odel^l/O)  : 

where  is  the  defineo  numrer  for  this  mode  and  0 inoicates 
that  all  control  f 1 aos  are  to  be  turned  OFF.  If  the  second 
carameter  was  1/  all  flans  would  be  left  as  set  oreviously. 

The  first  twO  routines  oresented  below  actually  set  the 
crocer  mode  themselves  (bv  callino  "setmode"  internally)! 
althouqh,  as  oreviouslv  mentioned/  tre  use  of  "setmoce"  in 
the  user's  oronram  is  considered  standard  practice.  These 
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are  "vector 

" and  "olotln". 

The  first  acceots  as 

oarameters 

two  sets 

0 f 

virtual  screen 

coo  hd i na  t e na i r s 

and  d r a w s a line 

bet  ween 

the 

two  ooinhs  that 

they  define.  It 

' s call 

would  ac- 

Dear  as 

fol 

lows  : 

vec  t or ( 

x1/yl»x2,v2); 

The 

secona  acceots  two 

edua 1 length 

a r ray s 

0 f real 

numbers 

and 

an  integer  value  to  denote  that 

1 enq  t h 

. It  then 

olots  tne  ooints  describee  by  the  c o r r escor a i na  x»y  values 
and  connects  each  successive  ooinr  ^itb  a line  f rorr  tne  pre- 
vious one.  Thus  if  two  arrays  were  declared  ana  initialized 
as  foil ows  t 

float  CJilnJ 

float  oy[n1  <yl,y2»v5f....»yn}; 
then  a suoroutine  call  of  the  for^ 

olot ln(cy»oy»n)  ! 

would  correlate  the  rescective  values  ^ron  the  two  arrays 
and  olot  the  points  with  connecting  lines. 

Another  routine  which  actually  sets  the  nrooer  Ticoe  by 
itself  is  one  wnicr  mignt  b“  utilized  in  conjunction  with 
"olotln".  This  is  the  "axis"  routine.  As  inolied  by  its 
nar'e»  this  subroutine  draws  a coordinate  axis  on  the  screen 
accoraing  to  the  two  real  nu-roers  it  acc“Pts  as  oaran-eters. 
It  wou'e  be  called  as  follows  : 


a X 1 

1 S ( X , y ) ; 

where  x 

and  V reoresen  t 

the 

he  s i red 

V i r h u a 1 

screen 

V a 1 u e s 

for  the 

i nt  ersec  t i on  of 

the 

axes. 
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ADVAt^CFO  '^FFHODS 


At  the  next  level  ^own  in  the  structure  of  the  soft/<are> 
there  are  several  routines  which  are  hiahly  functional  in 
this  systen,  Tho  first  of  these  is  the  proceriure  for  estab- 
lishina  a new  Current  Ooeratinq  Position  (COP).  To  reiterate 
its  usage#  a call  of  the  fornf> 

Strtxy(x,y); 

where  x and  y are  real  nun-gers#  would  establisn  the  CCP  at 
that  virtual  screen  location.  Frcr-  there#  a vector  con'd  ce 
drawn  to  another  ooint  by  utilizing  either  the  "coint"  or 
"oointr"  routines  in  tris  n^ge.  A call  of  the  fonr 

Doint(x#v); 

with  the  oarameters  necrose nhing  the  x ana  y values  for  toe 
desired  coint#  would  draw  a vector  fro*"  the  COP  to  that 
ooint  ana  estanlish  toe  CuP  at  the  new  coint.  (unless  toe 
fixed  ooint  flag  was  C''‘) 

In  similar  circumstances#  a call  to 

Dointr(dx#dv); 

would  draw  a vector  from  toe  COP  to  a coint  "relative"  to 
the  COP  as  determined  bv  the  "cnanoe"  values  oassed  as 
carameters.  “^ere  again  the  COP  would  be  established  at  the 
newly  calculated  coint  unless  *'ne  fixed  ooint  flag  was  UN. 

As  mentioned  in  "Control  !"oaes  ana  Flaas"  CChac  I \/ ) # tne 
fixed  coint  flag  is  turned  ON  and  OFP  by  a call  to 

f i X c t ( f ) ; 

where  f is  given  the  value  1 to  turn  ON  the  flag  or  tne 

1 1 “ 


value  0 to  turn  OFF  tre  ^ 1 aq 


If  t*^is  flag  is  Of.,  3 call  to  "strtxy"  estahlisnes  a 
fixed  point  from  whic*^  all  suosequent  vectors  will  be  drawn 
by  calls  to  "point"  or  "oointr".  In  effects  it  freezes  tne 
COP  until  the  occurrence  of  anotber  "strtxy"  conmano  or  un- 
til the  flag  is  turnec  OFF. 

Ihe  user  snould  oe  aware  that  each  tir-e  the  fixed  point 
flag  is  turned  O'^ir  a*ter  havino  been  OFF,  a new  "strtxy" 
call  is  PEGuIPED  to  establish  the  desired  fixed  position. 
The  flap  cannot  be  sin-rly  toqqleo  O^'l  ana  OFF  amiost  a series 
of  "point"  ann/or  "pointn”  caMSf  wifhouf  erratic  results. 


Other  flags  which  affect  the  operation  of  subroutines  in 
this  node  are  the  Indexed  liadressinq  flac*  which  was  ex- 
plained in  "Virtual  Screen  Aocressinq"*  anq  the  Reverse 
Bacxqrounq  flaq»  discussed  in  "Confrol  y<oaes  and  Flags". 

1.  PKOGRA'^  If 

The  safrole  crcdran  listed  below  is  available  in  the 
"csdOoO  - rantex"  directory  to  illustrare  a variety  of  the 
described  routines.  Selective  delays  have  been  employed  in 
the  program  to  allow  the  viewer  to  notice  the  following  : 

1.  the  cnanae  of  background  color  when  "colort(7)"  is 
executed  (necause  the  "ramtek"  routine  initializes  to 
color  taole  0); 

2.  the  efficiencv  of  "olotln"  in  orawino  the  first  three 
sides  of  the  star; 


IIP  1 

Jd 


3.  the  use  of  "oointr"  to  draw  the  fourth  s<oe  relative 


to  tf'e  third; 

t;.  the  use  of  "vector"  to  draw  the  final  side; 

5.  the  use  of  the  fixed  ooint  'retnoa  for  drawino  lines 
from  the  center  to  the  extreme  points  of  the  star, 
with  "ooint"  ana  "oointr". 

The  user  should  realize  that  "olotl""  establishes 
its  Own  initial  at  the  fi''st  coinr  ano  leaves  the  COP 

located  at  the  last  ccint  that  it  olots.  ne  shoulo  also  he 
aware  of  the  location  of  tne  CGP  before  and  after  each  of 
the  other  disolav  routines  are  called,  Notice  that  "strtxv" 
is  used  only  once  — ifrreoiatelv  after  turning  on  the  fixed 
oo  t n t f I ag . 

The  figure  displayed  ny  this  croqram  illustrates 
dramatically  tne  'stair-casing'  effect  that  occurs  wnen 
drawing  lines  at  yarious  angles  on  the  screen.  The  user  may 
also  notice  that  a horizontal  line  is  slig''t'y  'fatter'  than 
a vertical  one  cue  to  '■he  afore-mentionec  difference  between 
line  resolution  and  element  resolution  in  this  system. 

a.  To  use  tne  csdOOO  directory  ; 

LOGIN:  cs2000  c/r 
PASS//0P0:  St  u cent  c/r 
cd  ramte><  c/r 

b.  lo  list  the  crcgram  : 

list  -c  olS.c  c/r 
c/r 
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c.  lo  execute  t^^e  Droqram  : 


I 


c 1 5 . 


C / r 


d.  The  Hstinq  follows 


float  c X ( '4  1 { - 4 . 

float  dv(4)  i~b , 
i n t on  4 ; 
m a i n ( ) 

Tint  i ; 
r m r e k ( ) ; 
screen (-to. Of 
s 1 eec ( 2 ) ; 
c o 1 o r t ( 7 ) ; 
s 1 eeo ( 2 ) ; 
c o 1 o r ( 5 ) ; 
setToqe(4, 0) ; 
plotlnCoxfOVf 
s 1 eeo  ( 2 1 ; 
pointr(15.0/0 
s 1 e e p ( 2 ) ; 
vector(b.5f2. 
s 1 e e p ( 2 ) ; 
c o 1 o r ( 1 ) ; 
f 1 X o t C 1 1 / 
strtxvCO.TifO. 
pointr(o.5f2. 
s 1 e e p ( 2 ) ; 
f 0 r ( i = 0 ; i < "1 ; i 
(point  (ox  [ 1 
s 1 e e o 1 2 ) ? 

} 

> 


0f0.0,4.0/-b.'b>;  //neclare  arrav 

0, 6.5, -6.0, 2.0 > ; // 

//declare  array  length 


//ocen  the  qevice 

-10.0,10.0,10.0);  //set  screen  size 
//pause 

//select  color  taole  7 
//pause 

//select  color  5 

//set  Graphic  vector  oode 
cn);  //plot  the  array  points 

//pause 

.0);  //qraw  line  relative  to  CUP 

//pause 

0, -4.0, -6.0);  //qraw  with  "vector" 

/ /pause 

//select  color  1 
//turn  0‘V  fixeo  point  flag 
0);  //set  startina  point  (COP) 

0);  //draw  first  line  relative  to  COP 
//cause 

t+)  //qraw  re^naining  points 

1,0  y[i));  //  frorr  fixed  CCP 


XII 


GRAPHIC  PLOT 


A.  INTRODUC  I lOi'i 

The  DPimarv  function  of  tne  qreohic  olot  mcoe  is  tc  oen- 
erate  the  display  of  a nistoora'n  style  plot.  In  effect/ 
this  means  to  shace  nr  color  tre  area  cet-een  a selectea  x 
axis  and  a line  defined  oy  user-nenerateo  points.  Tnis  shac- 
i ng  is  actually  accomplished  oy  dra<vinc  a series  of  vertical 
lines  adjacent  to  eacn  other.  Tne  software  that  accomplishes 
this  is  built  around  a PAVTtK  hardware  feature  in  this  mode 
which  au t oma t i c a 1 1 V increments  the  element  address  cy  one 
after  each  line  is  drawn.  Thus  after  the  starting  element 
has  been  estaclishec»  each  successive  element  (proceeding 
left  to  rioht)  is  individually  afldressed/  until  the  final 
point  is  reached.  As  each  element  is  addressed/  a vertical 
line  is  drawn  from  a pre-selected  common  line  or  ' x axis'  to 
the  orooeh  line  address  or  v value.  Tre  most  obvious  appli- 
cation is  clotting  a 'function'  and  shaoind  the  area  b»t«een 
that  'function'  and  a certain  x axis. 


B 


BASIC  USEH  CUICELIMES 


To  select  the  arechic  olot  noae  the  user  shoulcj  make  a 
subroutine  cal'  of  the  form 

setmocie(5»0)  ; 

where  5 is  the  definec  number  for  this  moae  and  0 i nai cates 
that  all  control  flags  are  to  be  turneo  OFF.  If  a 1 were  in 
this  position,  all"  control  f 1 aas  would  be  left  as  set  previ- 
ous 1 V . 


Th  i 

S mode  i 

3 , 

in  effect. 

i mo  1 emen  t ed 

in  one  routine 

cal  led 

” o I 0 1 h " 

• 

Tnis  routine 

plots  a set 

of  x,y  coordinate 

points, 

as  did 

"ol 

0 t 1 n ” in 

the 

previous  chapter,  ana  th®n 

shades 

the  area 

'under 

the 

curve'  as  oe 

scripea  anove.  As 

with  "olotln". 

the 

"cloth" 

routine  reouires 

two  eaua 1 length 

a r ra^'S 

of  r ea 

1 

n umt  e r s 

that 

descrice  the 

'function'  to  ce 

plotted 

, and  an 

inteoer  va 

1 u e 

that  oenot“s 

the  lenoth  of  toe 

arrays.  it  also  reouires,  as  a fourth  oarameter,  the  real  y 
value  ( represent i no  the  x axis)  from  „nich  the  plot  shoula 
start.  Thus  a call  to  this  routine  wou'd  be  as  follows  : 


Dloth(o«,cy,n,hase); 


where 

" P X " 

ana 

"py" 

are 

the 

names  of  the 

arrays. 

M _ l» 

n 

i s 

the 

I eng  t h 

0 f 

the 

arrays  , 

and 

"hasm"  is  the 

des  i 

red 

case 

o f 

the 

histogram 

plot 

. For 

proper 

results,  the 

X V a 1 

ues 

must 

oe 

ar- 

ranged 

i n 

ascendi ng 

0 r 

r i 

in  the  array. 

[ 

i 
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1 


PROGRAM  lb 


This  samole  orogra'T',  available  Tor  execution  in  the 
'cscfOOO  - ramtek"  directory/  v«/ill  illustrate  the  nistograT 


s t y 1 

e 

plot 

achieved  ny  "oloth". 

Prior 

to  olottina 

the  histo- 

gram 

» 

a 

set  of  axes*  that 

will 

coincide  with  tne  center  of 

the 

0 1 

o t » 

are  oos i t i oned  on 

the 

screen 

. Tne  user 

Should  note 

that 

the 

histogram  overlaos 

ana 

w i oe  s 

out  these 

axes  in  the 

a r eas 

that 

are  common  to  tne 

two 

0 i so 

lays.  I * 

the  "axis" 

cal  1 

had 

been  olaced  aft^r 

the 

"oloth 

" c a 1 1 , t h i 

s conaiticn 

would  be  reversed.  Tne  routine  "olotln"  is  also  called  »itn 
the  same  data  to  ocint  out  tne  relaticnshio  between  tnese 
two  routines.  (Note  : The  "setnode"  calls  coulo  neve  been 
omittedf  since  both  "oloth"  and  "olotln"  set  t^’eir  own  re- 
auirea  modes  internally.) 

a.  To  use  the  cs2000  oirecfory  ; 

LOGId:  cs2000  c/r 
PASS/jQRO;  stucent  c/r 
cd  ramtek  c/r 

n.  lo  list  tne  orooram  : 

list  -C  olo.c  c/r 
c/r 

c.  To  execute  tne  orooram  : 

D 1 o . X c/r 

o.  The  listino  follows  : 

float  Dx(AO)  ii.(J.3.1fi.?»^.5»3.d,3.5f5.bf3.7»5.8»3.Pf 

S.0,5.I,S.2,5.3,S.4,S.5,5.o,S.7,5.3,‘3.Q, 
0.4.C.1 »o.2»6.3f0.  f»o.5fb.&»o.7fb.PfO.Pl  ? 
float  py.-iO)  (3.'.l,5.0»5.0>3.1f5.2»3.4»3.b»3.°/4.3>4,b, 


1 P4 


I 


5.5/5.b/5.^»b.l,fr,5/&.5»6.b/0.7,o.dfb.^» 

b,^»b.8»b.7,6.brb.‘5»b.S,b.l/5.‘^»5^b,5.5» 

^.b^y.3»3.‘^/5.o»3.'Jf3.2f3,l»i.U»3.0»3.u}/ 

i n t pn  u 0 ; 
float  pPase  5.0; 

ina  i n ( ) 

{ramte<(l;  //opan  t^'e  device 

SCreen(0.n,0.0,10.0,10.i)K  //set  airrensicns 
colo>'t(7);  //color  table  7 

color(l);  //color  I 

axisC'^.'^SfS.O);  //irawaxes  ,i 

s 1 eeo ( 3 ) ; / /cause 

color(7);  //color  7 

set-noae(5»0);  //select  q'*aonic  olct  oioce 

p 1 o t H ( c X , oy » on , on  a se ) ; //clot  nistograo 
s 1 eeo ( 3 ) ; / /cause 

colbrCS);  //cname  color 

se  t mode  f » 0 1 ; //charae  mode 

olotlo(ox»Dv,cn);  //plot  the  'function' 

} 


C.  AOVAfiCED  '''eTHCDS 


The  use  of  the  graohic  clot 
operations  than  can  be  accomol 
will  require  the  user  to  consult 
m i n g i*i  a n u a I 111. 


mode 

for  any 

more 

de  t a i lea 

i shed 

by  the 

" 0 1 O t h 

" routine 

the 

P A M T t h 

U X - 1 0 0 

Program- 

1^5 


XIII.  GRAPHIC  CARTESIAN  '-’OnE 

A.  introduction 

The  qraoRic  cartesian  "node  is  used  to  draw  solia  rectan- 
gles on  the  RAiVTE'^  screen.  These  rectannles  rrust  he  oeTinea 
by  two  aiaoonaily  ooocsite  corner  coints#  t^e  second  of 
which  oeco'Ttes  the  new  COO  ^trer  comoleticn.  Since  these 
rectangles  may  be  disclaved  in  any  color,  the  user,  by 
choosing  the  bacygrourd  color,  can  effectively  use  this  mode 
for  selective  erasure  of  rectangular  areas. 

b.  BASIC  USER  guidelines 

Selection  of  the  graohic  cartesian  mode  can  be  achieved 
by  a call  of  the  form 

setmoneCb, f ) ; 

where  6 is  the  defineo  nijmcer  for  this  mode.  The  oarameter 
"f"  should  have  the  value  d to  turn  OFF  all  control  flaos, 
or  the  value  I to  leave  all  flags  as  they  «ere  set  prior  to 
this  call. 


The 

S 1 mo  1 e s t 

i mo  1 e men t a t i on  of 

this  mode  is 

t h r ouah 

the 

"block" 

routine 

. The  user  must 

first  have 

selected 

h i s 

des i red 

color  by 

using  the  "color" 

routine.  Then 

the  cal 

1 t 0 

"block" , 

which 

reo  1,1  ires  tour  real 

numcer  oarameters,  w 

ou  1 a 

1 


appear  as  follows  : 


ctOC^CxljyljX^/V^); 


where  the  two  respective  cooroinete  cairs  rjetine  two  diago- 
nal ly  ooDosite  corners  o^  tne  gesirea  hIoc<  to  be  displayed. 
The  resulting  CG®  will  De  located  at  t^e  point  (x^/y?)*  t^e 
last  to  be  trans'"ittec  to  tne  PA‘'^T':K. 

The  "o’ock"  routine  does  out  the  i^AviTcK  into  the  graphic 
cartesian  mode  by  itself  and  it  also  does  some  fairly  ela- 
borate error  checking,  dut  a cuicx  scan  of  the  source  code 
would  reveal  that  the  actual  rectangular  oisolav  is  generat- 
ed py  issuing  a "strtxy"  call  followed  ov  a "point"  call. 
The  user  is»  of  course^  free  to  utilize  fhese  routines  also. 
In  fact,  in  some  applications  t-hev  are  essential. 

Thus  after  selecting  the  croner  mode  ana  color,  the  user 
could  create  toe  same  display  as  the  " clock"  call  a cove  by 
issuing  the  following  two  Subroutine  calls  5 
Strtxv(xl,yl);  POint(x?,v<f); 

(assuming  the  parameter  v/aluns  were  the  sam“  as  above). 

C.  ADVAMCED  yETmODS 

Althouoh  the  oasic  results  are  the  same,  a variety  of 
approaches  are  available.  Some  users  may  find  the  "gnintr" 
routine  convenient  in  applications  where  relative  addressing 
becomes  easier  to  compute  than  arsolute.  Thus  a^ter  using 
the  "strtxy"  routine  to  esfablish  an  initial  CCF,  the 
"pointr"  routine  could  be  called  rereategly  (as  could 
"point")  to  generate  a series  pf  linxeg  rectangles. 

\?.l 


There  also  mev  oe  certain  acoHcations  in  which  the  in- 
dexed aoaressino  feature  is  useful.  This  nay  ^e  inolenented 
by  the  "index"  routine  explained  in  Chanter  Iv  under  "Virtu- 
al Screen  Addressing". 

1.  PROGPAM  17 

This  samcle  crogran  is  available  in  the  "cs2000  - 

rantex"  directory  to  oracnically  aenonstrate  the  effect  of 
the  separate  routines  in  this  rode.  Tne  user  should  observe 
the  following  : (1)  tne  use  of  "dock"  to  draw  a rlock  in 

the  upoer  left  ouacrant  of  the  screen;  (2)  the  use  of 
"strtxv"  anri  "ooint"  to  draw  a sinilar  block  in  the  uccer 
right  quadrant?  (3)  the  'ise  of  relative  addressing  when  us- 
ing "cointr"  to  generate  two  small  coxes  in  the  lower  right 
quadrant?  C^)  the  use  of  indexed  adaressinc  to  position 
three  small  boxes  in  the  lower  left  quadrant?  (5)  the 
'selective  erasure'  effect  achieved  cy  selecting  color  0 and 
drawing  over  cart  of  the  blocx  in  the  uccer  riaht  ouacrant. 

To  assist  the  user  in  access  i no  this  crograrr  the 
followino  ouidelines  are  provided  : 

a.  To  use  the  cs2000  directory  ; 

L Li  G I d : c s 2 0 0 0 c / r 

PASSaQPO;  stucent  c/r 

Cd  ramtek  c/r 

b.  To  list  the  ore o ram  : 

list  -c  d17.c  c/r 

12P 


c/r 


c.  To  execute  the  orogra'T’  : 


p 1 7 , X c / r 

d.  The  listing  follows  : 
ma  i n ( ) 

{rantexT);  //ooen  tne  device 

screenCO. 0,0. 0,^0. 0,20.0);  //set  oinensicns 
se t mode ( 6 , 0 ) ; //select  graphic  cartesian  mooe 
colortf/);  //select  color  taole  7 

color(l);  //select  color  1 

b 1 oc k ( 3 . 0 , 1 3 . 0 , 7 . 0 , 1 7 . 0 ) ; //craw  a nlock 
sleeo(2);  //cause 

s t r t X V ( 1 5 . 0 , 1 7 . 0 ) ; //establish  new  CCP 
ooint(17. 0,13.0);  z/graw  a rloc< 

s 1 eeo ( 2 ) ; Z/oause 

color(3);  //select  color  3 

strtxyfl7. 0,7.0);  //estaolishnewCOP 

oointr(-2.0,-2.0);  //draw  "relative"  to  CCP 

oointr(-2.0,-2.0)  ; //  " " " " i 

s 1 eep ( 2 ) ; //cause 

color(l);  //color! 

index(l,l. 0,1.0);  //"index"  from  (1.0, 1.0) 

s t r t X y ( 2 . 0 , 2 . 0 ) ; //set  new  COP  j 

ooint(y.0,^t.0);  //draw  a block 

color(5);  //select  color  S 1 

s t r t X y ( 3 . 0 , 3 . 0 ) ; //set  new  COP  ; 

nointCS. 0,5.0);  //drawablock  i 

color(7);  //select  color  7 j 

strtxy(ii.0,'4.0);  //setnewCOP  i 

pointCo.  0,6.0);  //orawat'locx  | 

sleeo(2);  //pause 

inoex(0,0.0,0.0);  //t>.jrnnFPinaexflaa 

color('O);  //selectbacxgrounoco'or  ^ 

block(13. 0,13. 0,15. 0,15.0);  //"erase"  cart  of  a bloc<  J 


1 


XIV.  GRftPhlC  tl.EME'iT  Mf'DE 


A . IiNfRtOUUCT  ION 

This  mode  involves  dCtivatino  or  'oaintinq'  innividual 
elements  (cixels)  on  the  R^f'TEK  screen.  »men  oceratino  in 
the  arachic  element  "'oae  t^e  user  "^ust  comrutef  either  crc“ 
grammatically  or  ov  handf  the  virtual  screen  cocrdinares  ct 
each  pixel  that  ne  aesires  activareo.  As  such,  its  use  may 
may  not  seem  as  attractive  as  some  other  mooes,  yet  for  some 
aoolic'?»tions  this  mooe  may  prove  extremelv  useful. 

R.  BASIC  USER  GUlCEiriES 

The  graonic  element  mooe  may  ce  selected  bv  a call  such 
as 

setmode(7,f); 

where  7 is  the  oesicnated  number  of  this  ""oae.  Ire  second 
parameter  (f)  shoulo  ce  a 'O'  ho  turn  DPR  all  control  ti^qs, 
or  a '!'  to  leave  the  flaos  as  they  were. 

By  its  nature,  this  mode  oemanos  an  increased  awareness 
of  the  virtual  screen  dimensions.  The  screen  may  ce  aimen- 
sioned  to  any  size  the  user  desires  by  a call  of  the  form  : 
screen ( xmi n, ymi n, xmat  ,ymax  1 ! 

which  will  resulf  in  the  minimum  coordinate  values 
representing  the  lower  left  corner  tne  screen  and  the 


1 
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I 

maximu'"  values  reo^esent  i nq  tne  uccer  rioht.  There  are  sorie 


i ns  t anc  e s 

when 

V 1 e>^  i ng 

the  sc  reen  i n 

its  'real'  aimensions 

will  held. 

T n i s 

m,i  V 

be 

acnieveri  by 

usina  the  "screen" 

rout i ne 

t o 

set 

tne 

6<J0  by 

2^0  dimensions  by 

sc  reen  ( 0 . 0 » 0 . 0 » bau  . 0 » 2 <40 . 0 ) . <)ne  of  tne  more  useful  aoDli- 


cation 

rout i nes  in 

this  mode  is  tne 

"plotot" 

routine.  Tnis 

procedure/  as  with 

" D 1 o t h " a n o 

o 1 o t 1 n " 

i n 

p r e V i 

ou  s 

chapters/  requires 

as  parameters  two 

eaual  length 

arrays 

0 f 

real  numbers  and  an 

i n t ene  r value  def 

i n i no  t n a t 

1 e n g t n . T 

nus 

if  tne 

follcwina  arrays  were  declared 

and  i n i t i 

a 1 i zed  : 

float 

Cxlnl  (xl/x2/x5/. 

. . . / X n 1 ; 

f 1 oa  t 

pytnl  (vl/v2/yi/. 

..•/ynf/ 

then  the  subroutine 

call 

plotot (px/Py/n) 

would 

correlate  tne 

'n'  values  from  " 

c X " and  " 

C V " 

and 

ac  - 

t i vat  e 

those  'n'  inoiy'dual  oixels 

on  the  screen 

accord 

1 ng 

to  the 

currently  sel 

ected  color. 

Thp  "clotot"  routine  actua'lv  maxes  a series  of  calls  to 


the  familiar  "point" 

function. 

In  t n 

i s 

mode / the 

"ooi 

n t " 

rout i ne 

IS  used  *'0 

address 

i no  i 

V i dua 

1 

elements 

on 

tne 

sc  reen / 

not  to  define 

the  end 

point  of 

som 

e vector 

or  D 1 

00  < 

drawing 

orocedure  as 

before. 

Thus 

tne 

user  "ay 

util 

i ze 

"po  i nt  " 

to  activat® 

arbitrarv  oi 

X e 1 s . 

In 

is  can  be 

n e 1 D 

ful 

when  plottina  some  function  whos»  values  are  not  <no»n 
t3efore“hand.  (see  samcle  onooram  t?elc«) 


The  "oointr"  routine  mev  also  ce  used  to  anaress  so^e 
ele'nent  relative  to  the  oreviously  aaoressed  element  (loca- 
tion of  COP).  The  reverse  nackaroum  ana  indexed  aadressinq 
flags  which  were  exolained  in  "Control  '"^odes  and  Flags" 
(Chao  Iv)  are  apolicable  to  this  mooe. 


1.  PKOGPAV  18 


The  followina  orocram,  when  executed 
and  clot  the  coints  along  the  circumference 
the  same  time»  it  uses  the  results  o*  its  SI*'< 
putations  to  plot  a cortion  of  a sine  curve 
cle.  Tnis  orocram  is  in  the  "cs2000  - ramte<" 
can  he  accessed  as  follows  : 

a.  To  use  the  cs<?0O0  airectorv  : 

L 0 0 1 : c s 2 0 0 d c / r 


PASS.'iOPD:  stucent  c/r 

cd  ramtek  c/r 

b.  To  list  tne  orcnram  : 

list  -C  olB.c  c/r 

C/r 

c.  To  execute  the  oroaram  : 

p 1 8 . X c/r 

d.  The  listina  follows  : 

douD 1 e s i n ( ) ; 
douD 1 e cos ( ) ; 
float  c X ; 
float  o V ; 

float  or  3.9?  //radius  of  circle 

ma  i n ( ) 

(float  > » t J 


will  compute 
of  a circle.  At 
function  com- 
within  the  cir- 
directorv  ang 


1 3? 


pamtek.(1;  //ooen  the  device 

screen(-5.0»-‘^.U»S.O»5.0);  //set  oimensions 
colort(7);  //color  table  7 

Color(5);  //color  5 

setmoae(7j0);  //select  araohic  elefrent  ^ooe 
for(i  = 0.0;  i < o.(?83l3/i  = i t O.OIJ 
(ox  = or  ♦ cos(i); 
t = s I n ( i ; ; 

Dy  = or  * t; 

oo i n t ( o X , o V ) ; //olot  the  circle 

if(i  <=  o.O)  DO i o t ( ( i - 3 ) » t 1 ; //clot  sine 

> 


C.  ADVANCED  'VETHuDo 

The  araohic  ele'^ent  oode  seeos  best  suited  for  olottinq 
a series  of  ooints  that  are  conouteo  by  the  aoolication  cro- 

■c 

■t 

gram  itself.  Oecendinq  on  t^e  desired  disolay>  sor'e  orojects  i 

that  reouire  the  user  to  o r e-c  oi^ou  *■  e nis  data  ooints  night  ' 

be  more  aaaotable  to  me  of  the  Data  mooes.  (se“  piaster  and 
Transverse  Data  '’odes) 


I 
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XV.  RawTEK  I.VTERACTIvE  KEYBOARD 

The  RAmtek  keyboara  is  soft/vare  a<Yaotec!  to  be  utilized 
as  an  interactive  tool  bv  the  RAi^'TEk  user.  This  keyboard 

I 

(located  in  front  of  the  GX-IOOA)  is  ON  when  the  green 
switch/light  (in  the  uocer  rioht  corner)  is  alowinaJ  to  ac- 
tivate the  Keycoaro  when  it  is  OFF,  oepress  the 

1 

switch/light.  Tne  keyboard  is  confiouref  as  sho^n  in  Figure 

3. 

Referring  to  Figure  hi  the  user  will  note  that  there 

1 

are  eighty-nine  (BR)  keys.  Eac^’  i<ey  nay  rave  fron  one  (1)  to 

three  (5)  states  (ucoercase,  lowercase^  control).  Yhe  user  j 

I 

has  available  237  distinct  cooes  that  nav  be  transnittea  via  j 

the  keyboard/  with  the  ASCII  code  being  utilized  for  all  j 

i 

keys.  The  decimal  recres«ntation  of  the  actual  code  returned  I 

from  selecting  a particular  Key  is  shown  in  Figure  A. 

The  system  software  has  been  oesionea  to  allow  the  user 

i 

to  reag  kevboarj  input  quite  easily.  The  three  functions  j 

that  allow  the  user  to  interact  with  the  <evnoard  can  pro-  ! 

i 

vide  individual  ASCII  characters/  inteoer  numbers/  or  real  |: 

numbersdeoendinoon  the  functicnutilizeo.  t 


In  addition  to  reading  from  the  keyboard/  the  user  m^y 
echo  orint  bacK  to  tr«  PA‘>MFk  screen  individual  ASCII  cnar-  j 

j 

acters  as  thoy  are  rnao.  The  system  support  routine  "out(n)"  , 


oroviaes  tHis  capabiH’tv  < "n 


is  an  /'SCII  coaeb  cnaracter) 


r 


I 

\ 


I 


t 


The  function  "out(n)"  au t oma t i c a I I y reDOsitions  the  COP  one 
character  to  the  rioht  to  prevent  over- writing. 

The  function  that  returns  individual  ASCII  characters 
to  the  user  is  "retcharC)".  To  reaa  a character  from  tnp 
RAMIEK  keyroard  the  user  would  issue  a call  of  the  form 

X = refchar  f ) ; 

This  will  result  in  "x"  he  inn  assigned  tne  value  of  the 
select  eg  key. 


i 

r 

[ 

I 


A 


A.  PROGRAM  IR 

This  proararr  will  reaa»  and  ecno  print  to  the  PA^-’IEK 
screen#  characters  selected  fron  the  RAMTca  keyhoaro  (\bT 
ALL  SELECT  IU'JS  APE  PRI'';  TABLE).  The  program  terminates  when  a 
single  carriage  return  is  input. 

l.To  use  the  csEOOO  directory; 

L 0 0 I ; c s E 0 0 0 c / r 
PASSi'-'ORD:  student  c/r 

Cd  ramtek  c/r 
E.To  list  the  program: 
list  -c  pIP.c  c/r 
5. To  execute  the  oroaram: 

D IP . X c/r 

A.Phooram  listing  follows: 

^define  CR  IS 

m a 1 n ( ) 

Tint  x;  //inteoer  variaole 
ramtek();  //initial  i?® 

1 35 


i 


colort(7);  color(2)J  //selec  colors 
while  ((x  = retcrarC))  1=  CP)  //looo 
{strtxy(50.0,50.0);  //set  cositon 
out(x);  //echo  character 

To  read  an  inteaer  fro-r  the  RA^'TEh,  the  user  deoends 
upon  tne  system  function  "ueti()".  To  read  an  integer  Quan- 
tity from  the  key  board  the  user  issues  a call  of  the  form 

y = ae  t i ( ) ; 

The  function  "oetif)"  recognizes  a carriage  return  as  the 
end  of  the  incut  value.  To  inout  tne  value  one  hundred  the 
user  woulo  type  (at  the  RA'-ijph  icevboard)  ; 

100  c/r 

A negative  one  (-1)  is  returned  if  a carriage  return  is 
typed  as  the  first  character.  The  only  valid  inputs  are 
lowercase  numcersJ  all  others  are  ignored. 


8.  PHOGRa:^  20 


This  program  allows  tne  user  to  incut  inteaer  values 
from  he  xeyboard  until  a carriage  return  is  typed  as  the 
first  character  in  a new  number.  The  integer  value  is  outcut 
to  the  RAN'TEk  screen  for  user  verification  (see  "itoal(x)"l. 
l.Io  use  the  cs2000  directory; 

LOGIN;  cs20o0  c/r 


PASSi''QPD:  stuo“nt  c/r 


cd  ramtex  c/r 


2. To  list  the  program; 


s 


CONTROL  Ktrs  AND  ARE  ONCODED 


LC- ) ok»ercase 
UC-uocercase 
C r L •*  c o n t r c 1 


1 

145 

177 

2 09 

2 

14b 

1 78 

210 

3 

147 

1 79 

21  1 

4 

148 

180 

212 

5 

149 

181 

213 

6 

150 

182 

214 

7 

151 

183 

215 

8 

152 

184 

21b 

P 

153 

185 

217 

1 0 

154 

186 

216 

1 1 

155 

l«7 

219 

12 

15b 

188 

220 

13 

157 

1 89 

221 

1 4 

158 

190 

222 

IS 

150 

191 

223 

1 b 

91 

123 

27 

1 7 

uQ 

35 

1 7 

18 

50 

34 

lb 

51 

35 

19 

2 0 

52 

3o 

20 

53 

37 

21 

22 

54 

38 

22 

£3 

55 

39 

23 

24 

5b 

4C 

2 4 

25 

57 

4 1 

25 

2b 

4? 

48 

— 

27 

45 

b 1 

29 

28 

95 

125 

29 

29 

94 

12o 

3 0 

30 

02 

124 

2P 

31 

1 53 

1 85 

197 

52 

137 

lb9 

201 

33 

1 4 1 

175 

205 

34 

— 

— 

— 

55 

1 1 5 

81 

1 7 

3b 

1 19 

8 7 

23 

37 

101 

69 

5 

38 

1 14 

82 

18 

39 

1 1 o 

84 

20 

4 0 

121 

89 

25 

41 

1 1 7 

85 

2 1 

42 

1 05 

73 

Q 

43 

1 1 1 

79 

15 

44 

1 12 

8 0 

— 

45 

o 4 

Ob 

— 

4b 

95 

95 

31 

47 

10 

1 0 

1 0 

48 

1 3 

1 3 

1 5 

40 

— 

1 bO 

loa 

5 0 

1 34 

1 bb 

1 0 a 

51 

1 38 

170 

202 

52 

1 aa 

174 

20b 

53 

— 

— 

— 

54 

97 

o5 

1 

55 

115 

83 

19 

5o 

1 00 

bd 

4 

57 

102 

70 

b 

58 

103 

71 

7 

59 

1 0 ^4 

72 

d 

b 0 

10b 

74 

1 0 

o 1 

107 

75 

1 1 

b2 

1 u8 

7b 

12 

o 3 

59 

43 

27 

b 4 

58 

42 

2b 

o5 

8 

8 

8 

bb 

— 

— 

— 

o 7 

— 

Ibl 

1 9 3 

08 

— 

1 4 0 

19b 

b9 

— 

1'j2 

19  J 

7 0 

1 35 

lb7 

i QQ 

7 1 

1 39 

1 7 1 

20  5 

72 

145 

1 75 

20  7 

73 

— 

74 

122 

90 

2b 

75 

120 

88 

24 

7 b 

99 

b7 

3 

7 7 

1 1 8 

8b 

22 

78 

98 

bo 

2 

79 

1 1 0 

7d 

1 4 

80 

1 0 9 

77 

1 3 

dl 

44 

bO 

12 

82 

4 C 

b2 

14 

c3 

4 7 

6 5 

1 5 

84 

— 

— 

— 

65 

- * - 

lb3 

1 95 

8 e 

— 

1 b8 

20  0 

87 

— 

1 72 

Z 0 4 

8 8 

— 

1 7b 

208 

89 

52 

52 

5^ 
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SPECIAL  applications  PCuTINES 


XVI. 

The  Duhpose  of  this  chaor^r  is  to  oresent  those 
routines  ^rom  the  software  suroort  oac!<age  which  are  not  an 
inteara?  part  of  any  toric  oiscusseo  earlier,  ana  which 
woul-i  otherwise  n*  OTitteo.  So^e  cf  the  routines  in  toe  sud- 
oort  cacitaqe  are  nerely  suhorainate  oarts  of  larger  routines 
and  serve  no  stanci-alone  curoose.  Tnese  wiM  not  oe  dis- 
cusseg.  The  routines  cresentec  here  are  those  tha;;  -niqnr  ce 
efnoloyea  Cv  a user's  aoclication  croorarr. 

Tnere  is  only  one  routine  in  the  supcort  cacoqe  tnat 
requires  <nowledoe  af  the  fact  that  this  oevice  actually  nas 
512  raster  lines  -■  -tfiO  of  which  are  visiole  ang  52  of  «hich 
are  off  the  bottOT  of  the  screen.  This  is  tne  "scroll”  func- 


tion,  which  is 

used  to 

ma < e a 

display 

^ C V 6 

uO  or 

by  3 

certain  numcer 

of  real 

1 ines. 

If  a portion 

of  tne  disc'av  is 

'scrolled'  off 

tne  toe 

of  r r » 

S c r p n / 

It  w i 

11  'wrap 

aroung ' 

ana  reaoDear 

at  tne 

bottom  (ana  v 

ice  versa).  Tnus 

r np 

non-visible  lines  that 

exist 

off  the 

bottom 

of  the 

sc  r een 

must  be  ta<en  into  consioeration  when  masino  use  of  tris 
feature.  Tr®  subroutine  call  wou'd  aroear  as 


scrol  1 fai  rect  ion.nurrl  ines  ) ! 


w ne  r e 

rne  caramel’ er  "ci 

reel 

ion"  must 

ce  either  a "u"  for 

Jp 

or  a 

"d"  for  On.-,n , 

and 

the  " n u m 1 

ine"  parameter  is  a 

real 

number  aenoting  the  ounce r of  real  screen  lines  the  gisolav 


shoula  DP  "loved 


In  orevious  cfiacters»  scneen  aoaressinq  nas  Deen 
oresenter)  in  terns  o^  the  virtual  screen.  There  are  t’/»o 
routines  that  nao  these  virtual  addresses  into  real  (and 
visible)  screen  locations  (or  the  actual  oisolav  generator. 
These  are  "conve"  and  "convl".  The  "conve"  (unction  con- 
verts the  X coordinate  into  a real  screen  ele"ient  oosition. 
The  "convl”  (unction  converts  tne  i coord in0te  into  a visi~ 
ole  real  screen  line  nuncer.  Tno  conoination  o(  these  teo 
ae(ine  an  element/line  intersection  or  oixe'.  These  (unc- 
tions are  use a internally  by  all  the  so(t eare  disnlay 
routines  to  convert  user-de(ineo  addresses  to  real  screen 
locations  oetore  oassinq  fhese  to  the  KAmTE^  fcu((er  for 
display,  fhese  t«»o  procedures  Tay  be  enploveo  ov  the  user 
with  inniyidual  calls  sucn  as 

COnvo(*j;  convl  (y); 

where  "x"  and  "y"  are  tne  real  nunoers  o(  tne  desireo  virtu- 
al screen  admess. 


In  order  to  disclay  a oiven  int“oer 
o(  -32767  to  *32767)  on  the  screen,  the 
be  used.  This  routine  will  convert  the 
eter  into  its  ASCII  code  anq  display 
value  on  the  screen  at  the  COP.  The  call 

i t 0 a I ( n ) ; 

" IS  any  yalio  inteoer  value. 


value  (in  the  ranee 
"itoal"  routine  nay 
oiven  inteoer  oaran- 
the  desired  integer 
would  be 


1 a I 


where 


n 


any  yalio 


LiKSwise*  tne  "ftoa"  ^unction  may  oe  u sea  to  di sol av  a 


real  numner  with  no  more  than  nine  diqits  to  the  left  of  tne 
deci'^al  ooint  and  no  more  than  four  digits  to  tne  right. 
Thus  if  ”x"  were  a valid  real  numoer,  the  call 

f t oa  ( X ) ; 

would  disolav  tne  decif'al  ren  r esen  t a t i cn  of  that  number 
(comolete  with  decimal  point)  on  the  PAV.  TEh  screen  at  the 
location  of  fne  COP. 


The  "out"  function  taxes»  as  a sinole  parameter,  tne 
ASCII  code  for  anv  valid  character  anj  "dumps"  it  to  tne 
RA'^'IEH  to  disolay  fnat  character.  Since  tne  ASCII  coae  for 
the  cnaracten  is  reouireo,  this  may  be  acnieve^  in  two  ways. 
First,  the  character  may  oe  enclosed  in  single  quotes  within 
the  Subroutine  call,  sucn  as 

ouf ( ' < ' ) ; 

to  display  the  letter  or,  second,  if  tne  user  pre“aefines 
a character,  sucn  as  with 

0 n e f i n e C 0 A 0 5 4 


then  the  call 


out  (CC'^A  1 ; 

would  display  a comma  at  the  location  of  the  CCP.  The  x 
value  or  element  position  of  tne  COP  is  incremented  bv  7 
elements  to  prevent  destroving  rh^t  cnaracten  with  the  mayt 
to  be  Jisplavei.  (see  " Alphanumeric  ''’ode") 


As  briefly  menticneC  in  the  "AlDhanumeriC  i'^Ode",  raw 
data  is  passed  to  the  PA'iiEn  bv  tne  "gump"  routine.  This 


1 aP 


procecJwre  se'^c's  a ore-Oeclared  nufriher  of  r>ytes  of  data  from 


the  software  buffer  (called  "cuff")  to  the  hAN'TEK  hardware 
buffer.  The  numoer  of  hyfes  to  ce  oasseo  is  normally  kept  in 
"bytecnt".  The  address  of  the  ne«t  available  location  in 
"buff"  is  keot  in  a cointer  called  "ctrcuff".  Tnus»  for  ex- 
amcle»  to  seno  the  octal  value  UoOOl?  to  the  R/if-''T£K,  the 
followina  instructions  would  be  used  : 

*D*’rouff  - 'Jo00l7; 
ctrCuff+"t/ 
rvtecnt  = ovtecnt  +• 
dumofouf  f fCyteCnt  ) i 

To  operate  at  this  level  in  the  RAN'Tt’*’  environmentf  tne 
user  should  familiarize  himself  with  tne  h4'''T£K  GX-IOO  Pro- 
gramming ('’'anual  111  and  the  P«'''TEh  soft^ware  source  code 
available  in  tne  Lan. 


A I-'  P t M D I X b 


SOFT.'iAftE  SUPPPRr  FUNCTION  DESCRIPTIONS 


This  Apoenriix  contains  the  descriptions  of  the 
terface  routines  in  the  format  that  is  followed  in 
mentation  of  tne  UNIX  cperatina  system  in  the  T.aval 
duate  School  Computer  Lanoratcry. 
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tne  doc  u 
Postqra 


1 au 


«tSE»?v/eo  nOPQS 


^UOFF 

e r t h o 1 d 

aacn 

aqe  1 

Alpha 

ecaqe^ 

axis 

en  t no  1 a 

R^O^^ 

erase 

BkGP  F 

£b  S 

Hk  rn  j 

f i XD  t 

H ] an  k 

f 1 1 D 

8LK 

f name 

block 

f c 

box 

FPOFF 

n r ac  Ic e t 

FFO,\, 

bu  f 

f t c a 

buff 

ae  t f 

but  1 d 3 w 

a e t i 

D U f fc  1 

ae  t n urn 

0 y t ec  n t 

ge  t sw 

c 

ae  f X y 

C hcc  1 

GHAPhCPI 

C b rqe 

G P A P H fc  L 

C I r n o 1 d 

GP APpyfC 

cl  r t 0 1 

Head 

code 

b e aac  r r 

cone i t 

beat 

coke 

n 0 1 d X 

CC 1 i n t 

b c 1 d y 

color 

i n 0 e X 

C 0 1 0 r t 

i no  f r s 

Co  1 O r t D I 

i r s t r 

Co  1 Sw 

instl'iriStSO 

cor'd 

inter 

Cu’'''HA 

i n t 5 3 

CCNPO 

i n r 0 0 

con  ve 

i toa 

con  V 1 

i 1 0 a 1 

Cory 

lx  OFF 

CH 

I x0\' 

Cursor 

Lcv 

data 

1 c mno  1 d 

da  t ao 

LfcP 

OD 1 w i a 

LE  < 

d i sp 

LE  1 

dsoy c t R 1 

LE2 

dunp 

LLP 

ei  nst 

LLx 

LL  1 

setup 

LLE 

si xpak 

L ra 

size 

LTD 

S k i D 

I 1 1 r 

3SCALL 

LXO 

status 

m a X s tw 

St  rout 

m 0 r e i nst 

s t r t X y 

msw 

Swary 

n 0 - n 1 7 

symbo 1 

0 c t b 1 

s y s t b 1 

out 

t acc  0 I 0 r 

pause 

t a 0 a i m 

Dick 

t a 0 i n 1 t 

D I 0 t D t 

t an  s w 

o 1 c t 1 n 

tb  1 wbo 

D 1 0 t b 

t 03 1 a 

P 0 i n t 

terse 

PO i n t r 

t e X t 0 

n roc  1 

t f D i 

D rocP 

TRAdSD 

o r CC  3 

triple 

o r oc  ^ 

t X 

D r oc  5 

t X 0 i m 

03  t 

t X m a X 

o t rcu  f f 

t X rr  i n 

out  uo 

t V 

do  t r 

t y g i m 

go  t r 1 

t y m a X 

a t 

t y m i n 

guest 

UPC  n t 

a 1 

vector 

ramt  ek 

wait 

pastefi; 

D 0 F (- 

r g o i 

x.nON 

re  sc  1 r 

w r i ton 

r e t c b a r 

X a X i s 

s a y c 1 r 

xm  i n 

sa vs  t a t 

X m a X 

scissor 

X s «v  i ten 

SCR 

y a X 1 s 

sc  r een 

y a X i s f 

sc  ro  1 1 

V m i n 

3DCl) 

y ma  X 

s e t m 0 a e 

1 <i5 


axis 
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axis 


N A M t : 

axis  ” draw  coordinate  axis 


SYNOPSIS: 

a X i s ( X » V ) 
float  X / V ; 

DtSCRiPT luN: 

Draws  a cartesian  coordina''e  x ana  ■v  axis  cn  tne 
screen  with  center  at  user  - defined  scree'"  coordinate 
( X , y ) . 

The  oceration  13  totally  inoecenaent  of  anv  control 
no  ie  issuen  or^viously. 

Tne  CQP  is  left  at  (nax  x-value»y). 

fonnal  return  15  eero. 


DIAGNGST IlS: 

Peturned  “1  indicates  no  oortion  of  the  axis  lies  on 
the  user-defined  screen. 


f 


1 do 


b k rnd 


May  2\  I'*?? 


C k rna 


NAMt : 

bkrnd  ” cnange  rpverse  cackqroupd  flag 

SYNQPSIo: 

b k r n d ( g 3 
i n t a ; 

DESLRIP  r lUM: 

If  a is  zero/  t’“e  reverse  oacscgrcuncl  flag  in  t^e  con- 
trol nooe  is  set  to  zero/  i.e.  turned  off. 

If  a is  eaual  to  one/  the  reverse  nackqrouno  flag  in 
the  control  "^ooe  is  set  to  one/  i.e.  tu mea  on. 

I'lormal  return  is  zero. 


DIAGNOSTICS: 

Returned  “1  indicates  the  cassed  integer  a is  not 
eaual  to  zero  or  one. 


D 1 OC  l< 
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block 


NAMt; 

bloc'^  ~ bravw  soHa  block 
SYnUPS IS : 

block(xl»vl/x2»v2) 
float  xl,vl/x2»v2; 


DESCRIPT lUN; 

A solib  clock  is  Gra-^r  witc  cccosite  corners  as  de- 
ft nea  by  use  r-de  f i r>ea  screen  coordinates  (xl/vl)  ana 
(x2, v2)  . 

The  COP  is  left  at  (x2/y2).  The  oceration  is  indepen- 
dent of  any  Tiode  issued  oreviously  but  is  sensitive  to 
ail  flags  acolicaole  to  OraoHic  Cartesian  mode. 

tiorrral  return  is  zero. 


DI  ACi^JUST  ICS  : 

Returned  -I  indicates  the  block  can  not  ce  drawn  on 
the  user-definec  screen. 

SEE  also: 

index!)/  okma!)/  db  1 w i a ! ) 


bu i 1 dsw 


'^av  21 


bu  i 1 ds  ty 


NflMt : 

buildsv*  - build  logical  switches  on  tne  tablet 
SYMOPSIS: 

b u i 1 d S w ( s w » X h , X 1 / y n , y 1 ) 

^loat  xh,x1,yn/yl; 
i n t Sw  ; 

DESCPIPT luN: 

Allows  tnp  user  to  define  individual  logical 
'switches'  on  the  vector  General  Taolet  Cy  passina  t^e 
following  oaraneters  : 

1-  user's  logical  switch  number  (integer) 

2- hioh  X value  (real) 

3- low  X value  (real) 
a-hioh  y value  (real) 

5-l0"  y value  (real) 

--  thus  defining  a Selection  oox  and  assigning  it  tne 
desired  nuTber.  '■‘aximum  numper  of  switches  is  2'a. 

DIAGNOSTICS: 

Normal  return  is  tne  switch  number. 

Peturned  -1  indicates  attempt  to  create  more  than  25 
s w i t c h e s . 

SEE  also: 

s i xpax  ( ) ; t absw  ( ) ; 


c hnge 


21  1‘377 


c h nge 


MAMt  : 

chnge  ” c^anae  color  taole  entry 
SYNOPSIS  : 

Chnge(nurrb, entry, coot  ) 
int  nuirb,  entry,  cont? 

DESCPIPT ION: 

Chanaes  the  scecifieo  entry  in  tne  inaicateo  color 
table  to  the  casseo  nara'^eter  cant.  trioleC)  should 
beusedtocutcont  intotheDrooerform.  i; 

nuffb  is  the  table  number  in  «hich  the  entry  is  to  be 
Changed.  entry  is  the  entry  number  to  be  changed, 
cont  is  the  integer  t-velve  bit  code  '/.hich  is  loaded  in 
the  scecified  entry. 

Normal  return  is  zero. 

DIA&NOSl ICS: 

AM  errors  are  inaicated  by  negative  returned  values. 

The  error  values  ang  their  meanings  are  as  TollowiS: 

-1  Indicates  numb  is  less  than  four  or  greater  than 
seventeen  . 

“2  Ingicates  entry  is  negative  or  greater  tnan  fif- 
teen. 


s t E Alsu; 

t r i D 1 e f ) 


cl r t b 1 
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C 1 r t b I 


h AMt : 

clrtbl  - load  colof  table 


SYMCPSI5: 

cl Ptol (n»name) 

int  Hf  ♦na'^e/ 

DESCRIP  I rO‘j: 

Loads  co'or  tarle  '^u'r’ber  n with  rre  codes  cortaineo  in 
the  arrav  oointed  to  by  nare? 

The  array  is  an  inteoer  array  containing  sixteen  in- 
tegers which  reoresent  the  octal  cooe  of  the  color 
table  entries  netween  zero  ang  fifteen.  The  array  is 
^ assuT.ed  to  be  declareo  sixteen  words  in  length. 

i 

n is  an  inteoer  value  wrier  ranaes  fror  four  to  seven- 
teen. 

The  color  tables  fro 'll  zero  to  four  are  svster  defined 
tables.  They  contain  the 

Table  0 - Fifteen  shades  of  drey. 

Table  1 - Fifteen  shaoes  of  blue. 

Table  2 - Fifteen  shades  of  green. 

Table  5 - Fifteen  srades  of  red. 

If  the  user  desires  to  Tooify  a system  table  see 
i n t e r ( ) . 

I'Jortral  return  is  zero. 


DI AGNUS  r ICS  : 

Returned  -1  i''dicates  the  oassed  inteoer  n is  less 
than  four  or  greater  t^'an  seventeen. 


SEE  ALSU: 

triple!) 


color 
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color 


NAMt : 

color  - select  color 
SVNUPSIS: 

CO  1 O r ( S ) 

i n t s ; 

DESLRIPriON: 

The  oasseo  inteoer  s is  '■ro  nu'^r. er  of  the  oesirea  eo- 
fry  TO  the  current-  color  t^cle.  Tre  color  locafed  in 
that  eotry  will  re  uoeo  ‘or  a'  I sur. senuent  entities 
oisolayen  until  a different  color  is  issued. 

s is  Retweeo  ?ero  ano  fifteen. 

''lorrral  return  is  zero. 


DIAGMQ3I ICS: 

Returned  ~1  inoicates  the  oassed  integer  s is  neoative 
or  greater  than  fifteen. 


CO  1 OPt 
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C 0 I O P t 


MAMt : 

coloPt  ” select  -lisclav  coIcp  taole 


SYNOPSIS : 

col OPt ( t ) 
i n r t » 


QESCPIPI ION: 

The  nasse'i  caran-eter  t is  tt'e  nup’ber  c Y tne  coIop 


table  that  is 

sen 

t to 

the  P'i'-rtK  oevice  Yor  oisclay. 

t is  betv. een 

zero 

anO 

seventeen  . 

Noptral  retupn 

i s 

zero. 

DiAONos  ncs: 

PetuP>^eo  “I  innicates  t*^»  oasseo  inteoep  t is  nenative 
OP  QPeatep  than  seventeen. 


SEE  ALSO: 

c I p t c 1 ( ) 


c on  V e 
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con  ve 


NAWt. ; 

conve  - convert  an  x value  to  an  ele^nent  location 


SYNOPSIS: 

conve  ( * ) 
float  X ; 


OtSCWIPTTui';: 

Converts  a virtual  screen  x-oirension  value  or  aOoress 
into  a real  screen  element  cosition.  The  floatinq 
ooint  parameter  must  te  a valid  aa dress  comoonent  for 
the  current  virtual  screen  soace. 


OIAGNUST ICS: 

Returns  the  number  of  the  real  screen  element  oosi- 
t i on  . 

SEE  ALSO: 

C o n V 1 ( 1 ; 


k 


I Sa 


con V ) 
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conv  1 


iMAMt  ; 

conv)  “ convert  a v value  to  a real  screen 


StMUPSIS: 

C on  V 1 ( V ) 
float  y J 


DESLRIP  F lur; : 

Converts  a virtual  scr®en  y-cinension  va 
real  screen  lire  nunrer.  Tr®  floating  ooi 
nust  oe  a valio  a caress  co'^ccnent  for  the 
tua)  screen  soace. 


DIAuNOSI ICS; 

Returns  tne  nuncer  of  the  real  screen  line 


SEE  also; 

conve  F ) r 


155 


line  nurro® r 


1 ue  into  a 
nt  Dara^eter 
Current  vir- 


cursor 
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cursor 


N A M t : 

Cursor  - sotr^^rp  cursor  (V.G.  tablet  criven) 

SY\0P!3ltj; 

Cu  rsor  C J ; < 

extern  float  tx,ty; 

DESCRIPl  ION : 

This  routine  olaces  a cursor  or  tre  screen  of  the  RA'»- 
in  color  15  of  the  current  color  tacle.  Toe  cursor 
IS  aestructive  in  thar  it  erases  everything  tnat  it 
rasses  over.  Control  of  the  cursor  is  via  tne  VECTOR 
General  raolet.  v'hen  tho  pen  is  oeoresseo  the  cursor 
oisanoears  ano  exits.  The  x arg  y values  of  the 
oen/cursor  location  are  saved  in  tx  ang  ty  (must  ce 
oloual  to  the  user  crocram)  for  tne  user. 


01 AGNOST  ICS  : 
none 

SEE  also: 

terse()  , oetxv()  » tabdimf)  , tacinitC)  , screen() 


1 bb 


aa  t a 
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data 


NAMt : 

rJata  " oisolay  ra-j  aata 
SYNOPSIS  : 

da  t a ( name  f 1 ) 
int  ‘namef  l» 


•i 


DESCRIPIIUN: 

The  raw  oata  oasse)  in  the  linear  array  ocirted  to 
narrie  is  nisolaved  on  the  PA'-'fch  acccrcinq  tc 
Current  control  '^de. 


t y 
the 


1 is  the  lenoth  ot  tne  array 


ny  t es  1 


tiormal  return  is  zero. 

DIAGNOSTICS; 

Feturned  -1  innicares  the  oassea  integer  1 is  neoative 
or  zero. 


SEE  also: 

s t rout ( ) » 1 t t r ( J 


i 

I 


1S7 


ab  1 w i d 
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ab  1 v«  i b 


NAMt ; 

db)»»ia  “ c^anae  ^ounle  wiatn  ^ 1 aq 
SYNOPSIS: 

Ob  1 w i q C X ) 
i n t X ; 

OESCPIPT lOM: 


If  X is 

equal 

t 0 

z e r 0 » 

the  double  «idtn 

f 1 aq 

1 n 

t re 

cent  ro 1 

•^0  oe 

i s 

set  to 

zercf  i.e.  turned 

oft. 

If  X is 

eaua  1 

r a 

one  . 

tho  douole  i~idth 

f 1 aq 

i n 

t r <a 

C on  t r 0 ) 

node 

i s 

set  to 

one/  I.e.  turned 

on  . 

'iQ  r rr  a 1 

return 

i s 

zero  . 

01 AONUST  ICS  : 

Returned  -1  indicates  the  cassed  integer  x is  not 
equal  to  zero  or  one. 


SEE  Also : 

s 1 ze  ( J 


ISP 

L.. 


disp  '■■'av211'?77  aisp 


NAMt : 

disp  - Qisolav  a setectep  co'or  taole  (Iona  torn) 

SYfNiUPSIS  : 

d i sp ( n ) ; 
i n t n ; 

DESCPIPl lUN: 

The  color*  <:ar,  le  nenofea  dv  rne  inreaer  caraneter 
is  disolaved  or  tre  screen,  along  with  the  octal  code 
reauired  fo  generate  each  entrv. 

SEE  also: 

dspvc  t b 1 ( ) 


dsoyc  t b 1 
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a s r y c f:  n 1 


NAME. ; 

dspyctbl  ~ aisolay  a selected  color  table 

SYNOPSIS: 

dsoyctbl  (j  }; 
i n r j ; 

DESCPIPl lUN: 

Tne  color  to  ole  denoted  by  tbe  integer  carar>eter  'j' 
is  diSDl9yed  on  tne  Pif'-'YE*'.  Bac<grouno  color  is  entry 
0;  oisolay  color  is  entry  Id. 

SEt  also: 

d i SD ( ) 


dump 
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Pump 


1 

I 

NAME.;  j 

dump-senarawoatatofheRA^'IEK  j 

SYNOPSIS:  j 

dump(bi.jff»bytes); 
char  *buff» 
i n t bytes; 

OE SCRIPT  I UN  : 

'.‘.rites  ravy  aata  to  tt>e  rA.'-iTEh  instruction  buffer.  This 
routine  is  tor  )cw  leve'  control  ct  the  kANTEk  an 3 is 
very  restrictive.  Tne  raw  data  is  interpreted  accord- 
i nq  to  the  mcoe  and  ♦laas  set  within  the  device. 


DIAONuS lies: 
none 


SEE  also: 

write!)  r PArTEK  PRGGP  AM'-E  PS  ''IANlAL 


erase 
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erase 


NAMt ; 

erase  “ erases  the  screen 


SYNUPSI3: 

erase!  ) 


OtSCRIPTION: 

The  PAV’fFK  screen  is  erased  to  the  current  cackarouna 
color  fie»  state  or  tre  reverse  bac<qrouncJ  flagj. 


'-'ay  ?l  1^577 


■f  i X o t 


r ^ 


f i xDt 


NAME  ; 

fixpf  - cfianae  fixed  coint  fi.^a  in  control  mode 
SYNOPSIS : 

f i XDt ( X ) 

i n t X ; 

OESCRIPrioN: 


If  X is 

equal 

t c 

zero,  t h 

e 

fixed  ooint 

f 1 aq 

i n 

the 

control 

mooe 

i s 

set- 

to  z e 

ro 

1 i.e.  turned 

off. 

If  X is 

equal 

t 0 

one 

/ t h o 

f 

ixeo  ooint  fl 

aa  i n 

tne 

ccn- 

trol  mode  is 

set 

t o 

one  , 

i • 

e.  turned  on. 

e a n i m f It  1 on 

1 V 

1 n 

G r ao  h 

i C 

V e c t o r or 

G r aoh 

i c 

P1  ot 

mode.  In  Graonic  '/ector  moce  it  causes  all  suoseauent 
vectors  to  oe  drawn  from  a common  ooint  as  issueo  by  a 
subseauent  (or  tre  last  previous)  strtxyC).  In  Graphic 
Plot  mooe  this  flao  is  used  to  achieve  the  histcqram 
style  Dlot  of  "doth()". 

fiormal  return  is  zero. 

DIAGNOSTICS: 

Peturneo  “1  indicates  tne  cassed  inteoer  x is  not 
equal  to  zero  or  one. 


♦ t oa 
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f t oa 


NAML: 

^toa  ” converts  real  nuriters  to  ASCII  for  output 


SYNOPSIS: 

f t oa ( i n ) ; 
float  in: 


DESCRIPTION: 

Converts  a floating  noinr  nuttier  to  an  ASCII  co::ie  So 
that  it  .ray  te  cutnuf  ro  ^ne  KA^'TEr.  The  passed  float- 
ina  Point  nijrroer  is  hfrst  converted  to  the  ASCII 
representation  and  tnop  outcur  to  the  RA TEk  screen  at 
the  user  cefinec  C'^'F.  Allots  for  only  four  oicits 
right  of  the  decimal  clac®  and  eight  digits  left  of 
the  dec  i rta  1 place- 


DI AbNuS 1 ICS : 
none 


SEE  ALSO: 

g a t a ( ) / 


i t o a 1 ( ) 


aet  t 
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qe  t t 


N A^'t ; 

aetf  - r Pan  floa*’inq  point  nu^rber  from  kA^'TEk  kevboara 

SYNUPb  IS : 

qet  f ( ) 

DESbPIPl  IC'i; 

Returns  a floatina  point  nun-rer  t-oT  t^e  rii-'Tfc^  kev- 
boarn.  The  only  nuopers  recoonizeo  are:  an  optional 


minus  Sion  toll 

c 

«■  e o c V a s 

r r i 

nc  0 t 

o i q i t s 0 P t ' 

i 0 n a 1 1 V 

containinq  one 

0 e c i m a 1 p o i 

t » 

t r* 

folloAeo  cot 

1 on  a 1 1 y 

by  the  letter  ' 

e 

' f 0 11 o«eo 

C V 

3 3 10 

•'ec  int-c-ger. 

Normal  return  i 

s 

t r p float 

i na 

CO  i n r 

nunc  e r . 

SEE  also: 

oetnunC),  retcrari) 


get  i 
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ge  t 1 


get!  - return  an  integer  froT  ttie  RA^'^TEk 


SYMUPSIS  : 

ge  t i ( ) ; 


DESCRIPl  IU'm: 

Returns  an  inteaer  value  frori  the  KAi'^TEK  keytoarg. 
ASCII  ctiaracters  between  0 ang  9 > inclusively  i are 
recggnizea;  all  others  are  ignoreo.  L'gcn  tyr.  ing  a car- 
riage return  t^e  orocess  ceoinsJ  nence  carriage  return 
denotes  end  of  strina. 


DIAGNuSl ICS: 
none 


SEE  also; 

atoiC)  t retC^iarCI 


1 o6 


p 


ge  t num 
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get  nun 


fyAMt : 

getnun  - read  nunger  frgn  RAi'-'TEK  keytoang 


SYNOPSIS: 

ge  t nun ( b a s e ) 
i nt  base ; 


DtSCKIPT  lui'i: 


Returns  a ccsitive 
Ramies  keyooard.  ^lu 
on  tbe  keyooard  are 
routine  will  not 
comma  is  tvoeof  nor 
than  digits  from 
ten,  or  d i o i f s from 
e 1 ah  t . 


or  neoative  integer  numben  from  tne 
merals  tyceo  uc  to  a comma  or  a c^r 
consicerer!  to  oe  t^e  number.  Tne 
return  any  value  until  a c/r  or  a 
will  i»-  accept  characters  other 
zero  to  nine  when  rase  is  eoual  to 
zero  to  seven  in  case  of  base 


base  is  the  base  of  tne  inteoer  number  returned.  It 
is  restricted  to  eiort  loctalJ  or  ten  (decimal). 


Normal  return  is  the  inteoer  numoer. 


CIAGMOST ICS  : 

All  errors  are  inoicaten  bv  negative  returned  values. 
Tne  error  values  ana  their  meanings  are  as  follows: 

-1  Inoicates  a c/r  was  strucs  without  any  previous 
entries. 

-2  Indicates  tne  passed  oaramete''  base  was  not  eoual 
to  eignt  or  ter. 

SEE  AlSu: 

retcharC),  getfC) 


'I 


I 


lb7 


qet  sw 
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q e r s V 


NAME : 

aetsw  - get  tne  nu<ncer  of  a selected  logical  s^itc^ 

SYNOPSIS: 

qe  t sw  ( ) ; 

DFSOPIPT ION; 

Deternaines  if  t^e  user  has  selected  a valiG  logical 
Switch  on  the  Sector  Opoeral  taolet.  If  so»  it  returns 
the  nunoer  of  tret  S-iitch. 

OIAONOST ICS; 

Peturnea  “1  indicates  invalid  selection. 

SEE  also : 

buildswC);  sixra<(l;  tabs«(); 


get  X V 
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qe  t X y 


NAM& ; 

qetxy  “ aet  x,y  coordinates  of  a ooint  on  the  tablet 


SYNOPSIS ; 

qe  t X y ( o ) 
i n t D ; 

extern  float  tXftyj 


OESCWIPT  ion: 

Peaos  (into  glocal  variables  tx  am  ty)  the  x,y  coor- 
dinate values  fron  the  tablet  at  toe  coint  aefineO  ov 
the  tio  of  the  stylus.  If  the  oaraneter  'o’  is  a i» 
the  stylus  oust  be  deoressed  on  the  tablet  surface  to 
select  a ooint;  if  'o'  is  a 0,  the  cooroi nates  nearest 
the  tip  of  the  oen  are  rea-j.  These  cooroinates  are 
automatical  Iv  ccnverteo  to  virtual  tadet  cooroinates 
if  the  tablet  ras  been  redinensioneo  (by  a prior  call 
to  t acd  i Ti ) . 


inter 
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inter 


iNAMt : 

inter  - interactive  color  table  -nodification  routine 

SY^>1UPSIS: 

i n t e r ( ) 


DESCPIPT lUN: 

Sets  un  am  runs  a tutorial  orogra-n  that  enaoles  the 
user  to  loo*  at>  select  ang  "odity  color  tacles  ouring 
progra'T'  execution.  Tnere  are  txo  rasic  'Tones  in  «hich 
the  routine  coerates.  Each  of  trese  mooes  has  a 
series  of  commands  woicr  the  user  can  execute. 

1.  Paaing  voae.  Uoon  exec  1.1  tion  t^e  naoing  ^ooe  is 
immediately  entered  ar.g  a set  of  instructions  is 
oisolayed.  Tne  followinci  conmanas  are  then  accect- 
ao  1 e : 

D - Indicates  a carticular  table  numner  is  to  be 
oisolayeo.  The  number  rust  then  be  entereo 
between  zero  ang  seventeen. 

n ” Increments  table  numner  diSDiayeo  by  one. 

0 ” Decrements  taole  number  gisclayed  by  one. 

1 - Displays  instructions. 

o - Duits  ♦ror  the  interactive  routine. 

e - Enters  the  eiir  mooe. 

2.  Edit  ’'ooe.  .'.hen  the  edit  moce  is  entere'd»  a set 
of  instructions  IS  disolavec  listing  the  ccmmangs  trat 
can  ce  issued  ano  the  edit  met. hod  tney  initiate.  fre 
comrnan.'isare: 

t - Enrors  table  absignment  method.  Perm'its  en- 
tries from  any  taole  to  be  cocieo  into  the 
table  desionateo  ov  the  user.  Tne  taole 
nijmcer  which  is  to  receive  tne  cooieo  en- 
tries myst  oe  entered  first. 

o “ Enters  octal  assignment  method.  Entries  ■ ** 
scecified  im  g designated  table  Cv  enter>m 
the  ordered  '■riole  that  defines  the  cn  or 
lesire-.  The  fable  number  (^-17)  in  «,nicn 
the  entries  are  to  be  defined  ryji;  r e on- 


tered  first 


c “ Enters  co'ribinina  assianment  'method.  This 
•^ethoa  allows  the  user  to  logically  Cd  two 
seoarate  color  Iockud  table  entries  into  a 
selected  user  table  entry.  /Jhole  tables  may 
also  be  comoineo  into  a selected  user  table. 
The  user  table  number  (u-17)  must  oe  entered 
first. 

f “ Enters  inverting  tables  method.  This  method 
inverts  the  user  table  designated  by  the 
user.  Entry  ^ero  becomes  fifteen,  entry  one 
becomes  fourteen,  etc.  The  act  of  entering 
the  user  table  number  e^^ecutes  the  inver- 
sion. 

m - Enters  cocvinq  tables  method.  After  entry  of 
the  user  table  number  that  is  to  receive  a 
cobiec  table  the  number  of  the  table  to  be 
cooiec  is  entereo.  The  act  of  enterina  t^e 
seconc  table  number  causes  the  cccy  to  teice 
o 1 ac  e . 

UDOn  entry,  fne  editing  methods  disolay  a list  of  in- 
structions on  how  the  metnod  is  to  be  used  and  the 
results  obtainec.  Each  of  the  metnoos  have  ccmmanos 
that  may  be  issued.  The  leoal  commanos  for  eacn  eoit 
method  are  summ^ri^ed  below. 


- Table  Assignment  f^ethod. 

n - Inoicates  tne  table  number  ang  entry 
to  be  c cried  follows, 
c / r- I nc remen t s through  too  entries 
in  t^'e  receiving  user  table, 
c - Disclavs  the  color  lookuD  table  be- 
mcdifiea.  To  return  from  the  dis- 
blay,  tyre  a d. 

o - 'Tuits  nary  to  edit  roue  instructions. 


- uc^al  Assignment  i-’ethcd. 

n - Indicates  the  octal  triole  to  be  en- 
tered as  the  entry  follows. 

C / r- I no rempn t s trrcuah  tne  entries 
in  the  receiving  user  table, 
o - Tisclavs  the  color  looi<uo  table  be- 
ing modified.  To  return  from  tn«» 
disolav,  tyoe  a d. 

o - 'luits  bac^t  to  edit  mode  instructions. 


i 


- Co"'Dinina  Assionrrent  '''■ethocJ. 

n - Indicafes  tne  two  onereo  cairs 

desiqnat^no  the  table  number  ana 
entry  number  to  be  OPo  are  to  fol- 
low. 

c/r-Ircrements  throuch  the  entries  in 
the  receivino  user  table, 
o - Disolays  the  color  loot^uo  tarle 

beino  mooitiea.  To  return  ♦ro'i’ 
the  aisclav/  tyoe  a a. 
w - Indicates  two  whole  tables  are  to 
be  ccfnbined  (GPd)  and  their  num - 
cers  are  to  follow. 

q - Quits  back  to  edit  riode  instructions 

” Invertina  Tables  Nethod. 

o - Oisolays  tne  color  lookuD  table  that 
is  beinq  cr  was  inverted, 
o - Quits  oack  to  edit  rooe  instructions 

- Cooyina  Tables  Method. 

o “ Oisolavs  the  receiving  table, 
a - Quits  back  to  edit  mode  instructions 


i toa  1 
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i t oa  1 


N AMt : 

ttoal  ” converts  inteqers  to  ASCII  for  cutout 

SYNOPSIS: 

i t oa 1 ( i n ) ; 
i n t in; 


OESCPIPT  lOM: 

Itoal  ta^es  an  integer  value  anc  converts  it  to 
ASCII  codec  craracter  string.  -aving  converted 
value  it  is  tnen  aisolavea  at  the  user  defined  COP. 


DIAUNUSI Its: 

none 


SEE  also: 

ftoaC)  , gataC) 


an 
t ^ 6 


1 1 1 r 
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NAMt : 

Ittr  - aisclav  sinale  character 

SYNOPSIS : 

IttrCchfSwe) 
i n t c h » size; 

DtSoPIPIIC'-': 

»vill  nisc'av  f^e  c''3f'acter  cassen  /.ith  tt'e  size  iP'-ji- 
eaten  at  t^e  curre'^t  ocerati'iq  ooirt. 

After  vTisolav/  t^ie  currert  ooerafing  coint  is  on  t^e 
sane  line  ang  seven  actual  screen  elements  to  tne 
right  of  its  last  cosition. 

cn  contains  the  ASCII  cone  for  the  character  to  be 
displayed/  or  the  actual  character  enclosed  in  single 
aunt  es . 

If  size  is  eaual  to  one/  the  character  is  disulaveo  in 
stanharo  size. 

If  size  is  equal  to  twO/  the  character  is  displa/ea  in 
■JouD  le  width  size. 

The  operation  is  inoepenoent  of  any  mode  issued  orevi” 
ouslv/  out  is  sensitive  to  the  flaps  acplicaole  to  Al- 
phanumeric mode. 

Normal  return  is  zero. 

:^lAbNuSl  ICS; 

Peturned  ~1  indicates  top  cassea  integer  size  was  not 
equal  to  one  or  two. 


SEE  also: 

strouti)/  oataC)/  size!)/  inoex()/ 


w r 1 t c n ( ) 


out 
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out 


NAMt : 

out  ■*  outputs  ASCII  cnaracters  to  the  f'Af-'TtiK 


SY.NJUPSIS: 

0 u t ( c h ) ; 


DESCWIPIIUM 

Echos  the  oassec  ASCII  coaea  character  to  the 
screen.  Tne  CCP  is  then  i nc  r eiren  t eci  to  the  r 
orevent  o v e r w r i t i n-o  . 

Tyoical  call: 
ou  t ( US  ) ; 


DIAb^JUST  ICS; 
none 


SEE  ALSu: 

r^unpC)  , IttrCl  , r e t C ^ a r ( ) 


RAMTEK 
i oh  t to 


pick 
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Dick 


NAMt : 

pick  - outpijt  an  integer  net  ween  zero  ana  seventeen 

SYMUPSI3  : 

p i c k ( i ) ; 

inti; 

DESCRIPT  lU'i : 

Outputs  an  integer  to  tre  Rti''TEK  screen  (cet«een  0 ana 
17)  aeoendinq  entirely  upon  tne  cassea  Parameter.  In- 
flexiole  out  useful  in  displays  involving  color  table 
naninulafion. 


DI agOUST IuS : 
none 

SEE  also: 

data!  ) 


177 


P 1 0 1 h 
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D 1 O t h 


I' 

f 


NAN't : 


O I O t 


plot  aata  as  a histopram 


SYivjUPSIp: 

ciothCx,y,p,oase) 
^lodt  *x/  »v»  base; 
i n t n ; 


DtSLRI°  r lo’. : 

fna  values  y[il  are  treater)  as  functions  cf  *lij.  As 
the  function  is  olottea»  the  area  cetween  the  curve 
ana  the  x-axisf  as  aesiqnatea  Cv  base»  is  fillea  in 
with  the  color  last  selectea. 

That  portion  of  the  histoo ran  that  lies  on  the  screen 
will  ne  olotteo. 

The  operation  is  totally  inoependent  of  any  control 
node  issued  previously. 

X and  y are  pointers  to  linear  arrays, 
n is  the  nu.TCer  of  points  to  be  Plotted. 

'’■lomal  return  is  ze'"0. 


OIAbMuS  f ICS  : 

All  errors  are  inaicateo  by  negative  returned  values. 
The  error  values  ana  their  meanings  are  as  follows: 

returned  -1  indicates  the  Passed  parameter  base  is  not 
on  the  user-defined  screen. 


SEE  AlSU:  plotlnC)>  plotPtCT 


p 1 ot  1 n 
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p 1 o t 1 n 


li 


N A t : 

olotln  - plot  data  .^itt;  connecteo  lines 

SYMUP3I3  : 

olot ln(x/y/o) 
t I oat  * X » *v ; 

1 n t n ; 

OEoL^^lP  I lu’! : 

Tne  values  vu)  are  treateo  as  t unctions  of  x[il.  As 
the  function  is  clotted/  the  successive  points  are 
connected  tv  str-iiont  lines  of  the  color  last  select- 
ee. 

Tnat  oortion  of  tne  clotted  curve  /^hich  lies  on  the 
screen  will  he  plotted. 

Tne  ooeration  is  totally  inaeoenoent  of  any  control 
node  issued  previously. 

X and  V are  oointers  to  linear  arrays, 
n is  the  n under  of  coints  to  he  olottea. 


SEE  also: 

clothC)/  olotcttJ 


o 


M A M t : 

■>lotot  - plot  data  w'tH  points 
SYNOPSIS: 

olotPtCx»v»nJ 
Moat  *x  , ’*  y : 

1 n t n ; 


DESLPiP  ■ lU.,: 

Tne  values  ot  vM)  ar.-j  treated  as  t unctions  ct  xli]. 
Ine  Yuncticn  ig  plotte'"  .v  t t n dots  ^or  eacr  tx[ij»yCi]J 
coordinate.  Ire  oots  ire  in  tr. e color  last  select*‘d. 

It  a ooint  does  not  li  • on  t^e  user- defined  screen,  it 
is  not  olotted. 

Tne  operation  is  totally  inoeoendent  of  anv  control 
node  issued  previously. 

X and  y are  pointers  to  Hnear  arrays, 
n is  tre  numoer  of  points  to  be  clotted. 


St£  Also: 

plotnl)/  clotlnl) 


DO  1 n t 
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DO  i n t 


N AMt ; 


Doint  ~ Oefine  paint 


S r U P S I 6 : 

DO i n t ( X , y ) 

f i o a t X , y ; 


OESCPIPI 

Oefines  a ooint  on  the  yirtu^l  screen, 
lie  within  the  (jSfr--ie^'ne':i  screen. 


The  DOint  nust 


If  in  Graohic  Vector  mode»  (<>y)  oefines  the  enaroint 
of  3 yector  and  causes  it  to  oe  jra«n.  Tne  current 
ODeratina  ooint  is  than  (x»y). 

If  in  the  Graohic  .artesian  -Ticaer  (x,y)  defines  the 
diaoonally  oooosit/  comer  (froT  the  CiJP)  of  a oro- 
cosed  rectanale.  Tne  rectanola  thgs  oefinen  is  sraaeo 
in  the  cjrrent''v  sel*cteo  color.  The  cuurent  ooerating 
ooint  is  then  (*/yi. 

If  in  the  Graohic  F.  lerent  node»  (x»y)  defines  a sinale 
ooint  on  the  use''“dffineo  scr»en  ana  causes  a dot  to 
oe  'drawn  there.  The  ;urrent  oo;  rating  ooint  is  then 
( X » y ) . 

''lormal  return  13  zero. 


DI  AU'VUS  I luS  : 

returned  “1  indicates  the  oasseo  ooint  aces  not  lie  on 
the  user-dnfineo  screen. 


Set  AtSU; 

S t r t X y ( ) 


IHl 


DO  i n t r 
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DO  i n t r 


I'jAMt : 

DO  i n t P 


cieHne  a ooint  r-»''ative 


SYMUPoI  i) : 

DO i n t r 1 X » y ) 
float  X / V ; 


DESCPiP  I lu-i: 

i''efines  a ooiot  on  toe  usen-aefineo  scre^^n  relative  to 
pne  last  Current  ooerating  ooint. 

If  in  ijraonic  Vector  Tode  » vector  troT  tre  last 
current  ooeratino  ooint  to  a i-oint  aefinea  cv  tre  last 
Current  ooeratino  oninf  olus  a i so  1 ac  enen  t s x and  v 
is  a r a i«  n . 

If  in  the  i^raoric  Cartesian  moce*  a rectangle  is  de- 
fined oy  the  Current  ooerating  ooint  and  tre  ooint 
conputeo  bv  adding  X eng  v to  e COP.  Ims  rectangle 
is  disolayea  in  foe  ci  rrent  color. 

It  in  Oraohic  Elennent  '"Ode  a ciot  is  arai«n  af  a ooint 
defined  ny  toe  last  ourront  oi*  rating  ooint  olus  tre 
disD'acenents  x and  v. 

Tre  CuP  is  left  ar  tre  calculatec  location. 


S E t A L 5 u : 

S t r t X y ( ) 


1 0 > 


ramt “k 
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ramtek 


NAMt : 

ra'Titek  - initiates  S6MT£k  systeff 


SYi'^UPS  16  : 

ra'nt  ek  ( ) 


DESCPIPI  IUn; 

Initiafes  the  PAf-'TEK  system  anc  sets  tfie  oetault  con- 
ditions as  folloA/s: 


1 

- Initialize  tre  user-1<  fined 
100.0  in  X and  y. 

screen 

to  0.0 

t 0 

2 

- Loans  a srades  of  are/  color 
RA,v  rEt\  . 

table 

(C ) in 

the 

5 

a 

- Selects  color  fifteen  in  taole  zero 

- Selects  A 1 ohanune r i c control  mode. 

for  disci 

lay. 

5 

o 

- (Juens  the  RAViftK  for  r.*fding 

- Erases  tSe  screen. 

and  w r i 

t i no . 

i\iorma)  return  is  zero. 


DI  Abf>iGS  r ICS  : 

Returneo  -1  incicates  RA'--1TE*  device  coula  not  be 
opened . 


redim 


21  1^77 


red  i m 


'^a  V 


N A M t : 

redim  - redimension  the  values  reed  from  the  tablet 


SYNu2Sl3i 

red i m ( } ; 

extern  float  tx/tyJ 


DESLWi'^r  IuIj: 


l^edimensions  or  converts  *he  curreit 
read  Dv  "getxy"  to  virtual  tadef  c»or 
apolicaole  after  the  routine  "tabai'’" 
redimension  tne  virtual  tajlet  to  a us 
Tne  converted  ccortinate  va'ues  are  ol 
variaoles  tx  and  tv.  do  oarameters  a 
way  by  this  function. 


x,y  coordinates 
oinates.  This  is 
has  been  used  to 
e r -ce f i ned  size, 
aced  in  q 1 ooa 1 
re  passed  either 


SEE  AL3U: 

qe  t X y ( ) / 


1 ha 


reset  r 
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resc  1 r 


N A M t : 

resclr  - restore  tne  user's  color  taoles  to  tne  system 

SYJyoPoIa: 

resc I r ( 1 ; 

ciar  *savco 1 J 

extern  colortoltJU; 


OtSL>^l°  I Iu'<: 

Tne  user's  version  oT  tne  color  tanles  are  crouqnt 
into  tt^e  svstem  from  a user  file  citleo  "savcol"  /»Hicn 
must  nave  reen  created  ny  a orior  Cell  to  savclrC  3. 

r'J  ormal  return  is  tne  number  oT  bytes  reao  from 
"savcol"  into  "colortbinU"  (snould  be  ^^8). 


DIAGftuS  lies: 

Returned  ~1  indicates  an  u "’successful  attemot  to  ooen 
the  file  "savcol". 

•Returned  ”2  indicates  an  error  i i reading  from 
"savcol"  to  colortbini). 


SEE  ALSU: 

save  1 r ( 3 


reseat 
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rest  at 


NAMt: 

restat  - restore  the  2AMTEK  (anf  vG  Tadlet)  to  orevi- 
ous  status 


SY'XiUPGIS : 

r e s t a t ( ) ; 


DE3UP1P I lUN : 

Tne  control  status  that  •<as  in  effect  at  tne  ti^e  of 
the  last  call  tc  savstatC  ) is  restore o to  t^e  KAyTEK. 
Tnis  includes  nooef  control  ^laqs»  color  tarle»  ana 
tne  dimensions  of  tne  virtual  s;reen  anc  virtual  ta- 
blet. 


S t E ALSU: 

s a vs  t a t ( ) 


l6o 


s a V c 1 p 
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save  1 r 


MAwt : 

savclr  - save  tiie  cuPfent  co'op  tanles 

Strops i s j 

save  1 p ( ) 1 
cnap  *sdveoi; 
extapn  eoloptblUM; 


OtSLPiP  I I0i\: 

Tne  euppent  usep-availacle  eolop  taoles  Ca  - 17)  are 

save'i  into  a ne«ly-cpeated  file  ealleo  "saveol"  in  tne 
usep's  dipectopy.  Tnis  file  ^ay  suoseauently  oe  pe- 
ooened  and  read  dacK  into  tne  svsteTi  Cy  a call  to 
pesc)p(  ).  Fnis  allo-(S  the  user  to  ppesenye  aesired 
color  serenes  oetv^een  sessions. 

^fopnal  return  is  the  nuntier  of  ovtes  reac  into 
"saveol"  --  (snculd  be  9Ud). 


DlAuMOSl  IC.S: 

Petjrned  -1  indicates  an  unsuccessful  attempt  to 
create  the  file  "savcnl". 

Returned  “2  indicates  an  error  in  writino  to  "saveol" 
from  coloPtolU. 


SEE  Alsu : 

resc 1 p ( ) 


1 C A 


savst  at 
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savst  at 


I 


NAvtt ; 


savst  at  - save  tne  status  of  the  RAf'/'TEK  disclav 


SY'MUPoId: 

savstat ( ) 


DESLRIP  r lUf>i; 

The  Current  Control  status  ot  the  RAMfEK  and  VECTOR 
GE''1c,Pal  Tablet  is  saved  for  subseuuent  use.  This  oata 
includes  the  noce,  control  flaas/  current  color  tables 
and  the  dimensions  of  the  virtual  screen  ano  virtual 


sc  reen 
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screen 


■"lay 


N A M t : 

screen  - define  user  screen 


SYNOPSIS : 

sc  reen (xl»vlfx2-v21 
float  yl»  x2»  v2; 


DtSCPlPnUN; 

Defines  a standard  cartesian  coordinate  system  of  any 
scale  for  tne  user.  The  ooint  (xl/yl3  becomes  tne 
Coordinate  of  tne  lower  left  corner  of  tne  screen. 
Tne  point  (x2»y2)  oecones  tne  coordinate  of  tne  ucoer 
right  corner  of  the  screen. 


xl  T!ust  oe  strictly  less  than  x2. 
yl  must  be  strictly  less  than  y2. 

All  subsequent  user  coordinates  are  interoreteo  ac- 
cording to  this  user-oefined  screen. 

Normal  return  is  zero. 

DI AONUS I ILS : 

Returned  -I  indicates  xl  is  not  less  than  x2  or  yl  is 
not  less  than  y2.  An  error  message  is  also  crinted  on 
the  terminal  screen. 
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sc  ro  1 1 
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sc  ro  1 1 


N A M t ! 

scroll  ~ scroll  screen 


SYNOPSIS : 

scrol 1 (a»cnt ) 
c n a r a ; 

^ I oa  t c n t ; 


DtSCKlPf  Io'j: 

Tne  current  aisDlayed  oicture 
scrolled  uD  or  a own.  Infor-natic 
o^  tne  screen  will  oe  scrolleo  in 


on 

the 

screen 

1 s 

SC 

r 0 1 led 

off  the 

t OD 

i n 

tne 

DO  t t Oft 

ana 

V 1 c e- 

versa  . 

1 f a 
will 

is  the  Character  ' 
o e down. 

a ' , the  d 1 

r ec  t ion 

of  tne 

scrol  1 

If  a 

will 

is  the  Character  ' 
oe  uo  . 

u ' f the  d i 

r ec  t ion 

of  the 

scrol 1 

cnt  i 

the 

than 

s the  numoer  of  user-defined 
oicture  is  to  oe  scrolled, 
the  virtual  screen  height. 

V -un  i t s 
cnt  Can 

Clines)  that 
be  no  larger 

tl  o r n a 

1 return  is  zero. 

■* 

D I A L>  I'i  U S i I L 3 ; 

All  errors  are  indicated  dv  negative  returned  values. 
The  error  values  ang  tneir  neaninqs  are  as  follows: 

-I  Indicates  the  oassed  oaraneter  cnt  was  less  than 
;tero  or  greater  tnan  toe  screen  neiont. 

-2  Indicates  t’ne  oassed  narameter  a was  not  a 'o'  or 


1 di 


set  rnode 
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set  '"Ode 


name  : 

setnnoae  - select  control  mode 


SYNOPSIS: 

se  t mode ( a » b ) 
i n t a » b ; 


OESCRIPT I jN: 

Selects  the  contr-^l  mode  accordinq  to  tre  oassed 
oarameters  a and  n.  a reoresents  the  control  ""ooe  as 
f o 1 lows: 

0 - Alonanumeric 

1 - Transverse  Data 

2 - Raster  Data 

3 - Como  lex  Data 

'-4  - Graohic  vector 
5 - Graohic  Plot 
D - Graohic  Cartesian 
7 - Graohic  Element 

All  flaqs  are  turned  off  if  b is  eaual  to  zero.  If  o 
is  equal  to  one»  anv  flaqs  set  in  tre  orevious  mode 
are  also  set  with  the  mode  selected  nv  a.  All  enti- 
ties disolaved  suoseauent  to  this  call  are  disclaved 
according  to  the  selected  mode.  Routines  that  oisre- 
qaro  th«  selected  mode  are  axis()/  blockC)»  inter(), 
lttr(),  olotRClf  olotlnCl,  olototC)/  texto()»  and  vec- 
tor!). 

Normal  return  is  zero. 


DIAGNOSTICS: 

All  errors  are  indicated  by  negative  returned  values. 
The  error  values  and  their  meanings  are  as  follows: 

-1  Indicates  the  oassed  oarameter  a was  less  than 
zero  or  greater  than  seven. 

-2  Indicates  the  oassed  oarameter  c was  not  eaual  to 
zero  or  one. 

SEE  Also: 

ra'htexC)/  Dkrna()»  dolwio(),  fixor()»  index!)/ 
w r i ton!  1 


I R2 


si xoak 
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SI xoak 


N4ME : 

sixoak  - select  from  six  stan-iard  switches  on  tablet 

SYNOPSIS: 

s i xoa k ( ) ; 

DESCRIPTION: 

Establishes  a oacxaqe  of  six  selection  boxes  or 
Switches  on  tne  Vector  General  tablet  (accoroinq  to 
Temolate  1)  and  returns  the  numoer  of  the  Switch 
selected  oy  tne  user  with  the  stylus. 


DIAGNOSTICS: 

Normal  return  is  the  number  of  the  Switch  selected 
( 1-b)  . 

Returned  -1  indicates  invalid  selection. 


SEE  ALSO: 

buildswC);  oetswC):  tabswC); 


size 
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size 


NAMd; 


size  - select  letter  size 


SYNUPSIS ; 

s 1 z e ( r ) 
i n t r ; 


DESCRIPTION: 

If  r is  equal  to  one  the  shandan  character  size  is 
usea . 

If  r is  eoual  to  txo  the  double  uiidtn  cnaracter  size 
is  used , 

Sets  the  douole  wiJth  flaq  in  the  control  moae. 
Tnerefore  size  takes  the  sare  action  as  ODlv.iq(lI. 

Nomal  return  is  zero. 


DIAGNOSTICS: 

■Returned  -1  innicates  the  oassea  oara*eter  r is  not 
equal  to  one  or  two. 


SEE  ALSO: 

dolwid()f  strout()f  lrtr() 


9j 


St  rout 


■“'av  ^1  l'’77 


St  rout 


(MAMt, : 

Strout  - outout  character  strina 


SYNOPSIS: 

strout(so) 

C n a r * so ; 


OESC^^  IPT  I&fv; 

Outouts  a character  string  no  greater  tran  li)0  crarac” 
ters  tong  oeqinnina  a*’  tre  current  ooerating  ooint  ang 
continuing  on  tr«  sane  line.  After  conoletion^  an  au- 
tofratic  line  feeo  occurs  wrich  defines  a new  current 
ooerating  ooint  on  tne  next  Hne  at  the  sa^e  starting 
ooint  as  the  oreviouS  line. 

so  Doints  to  t-e  craracter  string  to  oe  cutout. 

'lormal  return  is  zero. 


DIAGNOSTICS: 

Returned  -1  indicates  the  string  ccntaineo  nore  than 
too  cnaracters.  In  this  case  no  characters  will  be 
d i so  1 a ved . 


SEE  alSu: 

natal)/  sizeM.  lttr(),  textoC) 


j Strtxy  '^av21l*^77  Strtxy 

I 

I 

! NAMt: 

I strtxy  - establish  current  ooeratinq  point 

j 

j SYf-iOPSIS : 

I Strtxy(x»y) 

[ f 1 oat  X , V ; 


DESCPIPTIOM; 

Establishes  fie  current  ooeratinq  po'nt  on  the  screen 
for  suoseauent  i ns  t rue  f i ons  . If  t'e  current  r-ooe  is 


iJ r aon  i c Vector 

with 

the 

f i 

X ed  no i n t 

flag  set , it  es- 

t ab  ] 

i s h e s t ne 

oase 

f r on 

which  the 

V 

/ctors  are  drawn. 

X i s 

a user-oe 

fined 

sere 

pn 

1 0 c a t i 

)0 

i n 

X . 

V i s 

a user-oe 

fined 

sere 

en 

1 oc  a t i 

i n 

y . 

( X , y 

} n u s t lie 

with 

in  t h 

o 

user-oe 

fined 

screen. 

'iornat  return  is  zero. 


OIAui'iOSTICS: 

Peturne-3  “1  inoicates  (x»y)  aoes  not  lie  on  the  user- 
'iefine':!  screen. 


SEE 


1 

I 

I 


al3  J : 

f i xot  ( ) » 


screen!),  ooint() 


1 


i 
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symbol 


2\  I'’?? 


symbo  1 


iJAMt: 

symcoi  • di'solay  a soecial  svfbol 


SYNOPSIS: 

symDo 1 ( sy  ) » 
i nt  Sy  (b)  ; 


DESCPiPTION: 

Dra-^s  the  symool  that  has  oeen  oeHneo  by  tne  user. 
Thus  tne  user  nuay  oefine  soecial  sy'^rols  to  auament 
tne  standard  ACSII  craracte-  set.  Peauires  tne  oointer 
sy  to  the  user-defineo  a^ray.  This  routine  automati- 
caMy  ou touts  15  bvtes  in  th»  Transvirse  Data  moae. 


tyoical  data  declaration: 

int  alonatl  (0  00  0 0 00»000  0 0'4  2f 

I 0,0052042, 

0000000,  ooi)>''ooo}  ; 


tyoicalcall: 

tdatalalona, 12,50.6,50.0); 


SEE  also: 

t da  t a ( ) 


t abco 1 or 
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t abc o 1 or 


NAMfc: 

tahcolor  - taolet  color  "lan  i du  1 a t i on  function 

SYNOPSIS: 

t aoco 1 o r ( ) ; 


DtSCRIPflu-: 

Allows  for  the  interactive  "^ojifi  cation  of  color 
tables  via  tne  VECTOR  GE'iER-'L  MdLET.  The  svsten 
ornmors  for  raqyippfj  inouts  f r the  ratlet.  A te"'” 
plate  for  tho  tablet  is  reouircq  for  input.  The  ♦•ablet 
-rust  ne  initialized  orior  to  'i/lling  tabcolor  (see  ta- 


tabai  m 
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t abd  i tn 


MAMt  : 

tapdim  " rediTiension  the  /irtual  taclet 
SYNOPSIS  : 

taDdiT(*'^ax/X'T'in,vmay,vf"ir  I 
douple  X Ti  a X , X m i n , v'T’a  X » vm  i r ; 


DESC^^IPT  ION: 

Accents  as  oa^aTetefS  a •laxi'mj"'  anr  Tinimijfr,  value  for 
the  X and  y oi-nensinns  (in  t"iat  crrjer)  and  'sets'  the 
tanlet  to  tnese  diTensions.  Allou  the  user  to  view 
tne  virrual  raclet  in  any  size  tattern  that  conforrrs 
to  tne  standard  Cartesian  arid  ('riririjn  x/v  values 
reoresented  at  t^'e  lower  left  comer;  'raximum  x»y 
values  located  a *■  the  uooer  right  corner). 


t ab  i n i f 
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t ab  i n i t 


taDinit  - ooen  t^e  taolet  foi'  fhe  user 


SYNOPSIS  : 

t ab i n i t ( ) ; 


DESCRIPTION: 

Ooens  the  Vector  General  tablet  and  establishes  user 
access  '/ i a f i 1 e“oo  ' nt  er  foi.  Sets  the  Taxirrun  nu'^cer 
of  loaical  switches  a\/ailabl^  to  2S.  Prints  ar  errcn 
Tiessage  if  unaole  to  ooen  tie  device. 


i 


200 


t absw 
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t absw 


NAN'E  ; 

tabsw  ^ interactively  rtefif®  switches  on  the  tablet 


SYi'jOPSIS: 

tabs'/«(sw) 
1 n t s w J 


OESCPIPTIUN: 

Allo'«s  the  user  to  aefine  a set  of  logical  switches  on 
the  taolet  bv  utilizinj  the  stvlis  to  select  tre  low 
set  of  coordinates^  thei  the  high  set  of  coordinates 
(ie»  the  lower  left  iorner  of  the  desireo  selection 
boxf  tnen  the  ucoer  riqrt  come'  of  the  box3.  Tie 
numcer  of  Switches  to  be  defined  is  indicated  by  the 
Daraoeter  'sw'.  The  sw-^tches  are  numoered  seouentiaMy 
as  they  are  defined. 

Prints  the  Xfy  values  as  sele;ted»  along  with  the 
Switch  '^numoer  assigner  after  each  selection  orccess. 


SEE  ALSO; 

buildswC);  getswC);  sixDa<()» 
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texto  *^av2ll'577  texto 


MA^E : 

texto  “ oisolav  a block  of  t?ft 


SYNOPSIS : 

texto(txtfCtao/Co1  »sz*wo).‘ 
int  ctaD/Col/SZ/-«o; 
char  *txtl  ) { >; 


DESCPIP I ION  : 

The  '^ultiDle~entry  array  of  variaole  lenoth  character 
strings  a '1  dressed  Oy  *t-xt  is  oisclayeo  on  tre  PA'-'IEK 
according  to  tre  other  oarameters  : 

ctab  =>  desiren  colaf  table  numoer 
col  =>  color  entry  -,100  that  tacle 


s z = > d 

esired  chara 

;*er  size  (1  or  2) 

A 

II 

o 

•9 

1 f 

a la i t 1 ve 

'rite  is  des i rea  > 0 

if  not 

re  t u rn 

j s 

ze 

OIAG'JCSr  ICS: 

Peturneo  -1  indicates  on?  of  the  character  strings  is 

too  long  (over  100  characters).  , 

Mljlt:  any  strings  Over  PI  characters  in  length  *iill 

"nrao  around"  the  screen  ^-o  thesa^e  line. 


? <; 

^ 


t dat  3 
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tdata 


NAMt: 

taata  - outputs  transverse  T/ta  for  toe  user 

SYi'ViuPSla: 

t da t a ( t rd/ b V / X , V ) 
i nt  t rd  [1  ; 
i n t by  ; 
float  X , V ; 


DESCPIPriuf'.; 

Ttie  variable  trc  is  t'^e  ni^e  of  an  array  containing 
the  transverse  data  oetinition  for  the  image,  by  is 
the  number  of  bytes  to  pe  passed  ; x » y are  the 
starting  points  for  the  desired  o'sclay.  The 
transverse  data  is  orpcesJed  bvte  by  byte  with  each 
byte  being  oisplaye'  aire<  tlv  beneath  the  last  one. 


typical  data  declaration: 

i r t a 1 D h a f]  { 0 0 0 0 0 » 0 , 0 0 0 0 0 d ? » 

00b22i  0,00520^2, 

0 0 0 0 0 .1 0 , 0 0 0 0 0 0 0 y ; 


typical  call: 

tdat3(alcna»12»S0,' ,50.0); 


The  function  will  not 
as  it  Dumps  to  f ne  r i 
user  selected  y value 


PfrTiit  'roving  off  of  the  Screen 
ihr  one  byte  ang  repositions  tno 
•ndccntihues. 


01  AijtiUS  r ICS  : 
none 


SEE  ALSO : 

setmode  (}  , sy'^bolf) 
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terse  I'''av211'^77  terse 


NAM£  ; 

terse  - selectivelv  erases  the  screen 


SYNOPSIS: 

terse(era»erb»erc»e. rrl)  ; 

float  eraferb,etc»erH; 


user  to  selectively  erase  a oortion  of  tre 
rassing  t^e  '•goroinates  of  two  opcosite 
a Rox.  The  are  within  the  Oefineo  cox  will 
to  the  bac unround  colon. 


DIAbNQSTICS: 

none 


S£h  ALSO; 

strtxyC)  , oointC)  » setnodeC)  t blocxC) 


OESCPIP  riO'i; 

Allows  the 
sc  f*een  n v 
c 0 r ne  r s of 
be  pa i n r eo 


20S 
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triple 


triple  - cone  cclor  from  t h ree“nuTiber  triple 


SYNOPSIS: 

triple! b»q»r) 
i n t b » q » r ; 


OESCPiPTlQM: 

Yne  three  input  panameters  represeotirq  the  intensi” 
ties  blue(ol»  greenCq)  and  rentr)  are  ceded  into  an 
inteaer  wrich  's  suitable  for  insertion  into  a color 
taole  entry. 

p is  oet«een  0 a '^c.  IS  and  represents  toe  intensity  of 
blue  desired. 

q is  between  0 ano  IS  and  reoresents  toe  intensity  of 
qreen  desired. 

r is  between  0 and  IS  and  represents  toe  intensity  of 
red  desired. 

t'ormal  return  is  an  inteoer  representing  the  cooe. 


OIJiONOST  ICS: 

Peturnec  -I  indicates  input  nara'^eters  or  o or  r are 
nenatiye  or  qreater  than  15. 


SEE  also : 

c h nqe ( ) » c 1 r t b H ) 


vector 
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vector 


NAVt : 

vector  - ora»j  single  v<=*Ctor 
SY\*0PSIS: 

vectcr(xI,yl»x2»/2) 
float  xl»  yl»  x2f  y2? 

UESC^^IP  r ION: 

A vector  is  orann  cn  t^a  screen  frorr  user~aefined 
screen  cooroinate  fxl»yl)  to  (x2fy2).  The  current 
operating  ooint  is  'eft  at  (x2/y?). 

The  ooeration  is  ingeoenoent  of  any  ^ooe  issueo  rrevi- 
ousty  Out  is  sensitive  to  the  f'aos  aDo'icable  to  the 
Graohic  Vector  control  mooe.  Onoesired  results  "ay  he 
oOtaineo  if  the  fixot  f 1 ac  is  set  crevious  to  calling 
vector ( ) . 

Normal  return  is  zero. 

DIAGNOSTICS: 

Peturneo  -I  inoicates  no  cortion  of  the  indicateo  line 
lies  on  the  user  defineo  screen. 

SEE  ALSO: 

bkrndf)/  dolwidil/  fixotf)/  indexC) 
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[ 

I 

(\l  A M t ; 

writon  - additive  write 

SYNUPSIS; 

w r i t o n ( w ) 
i n t w ; 

DESCRI^’riQM; 

!f  w is  a one»  ere  additive  write  ^'ag  in  the  control 
Tode  is  turnpo  on  causino  sudseouent  entities  in  Al- 
DhanumeriCf  ^aster  Data  and  Transverse  Data  Tiodes  to 
write  on  toe  of  orevious  entities  without  oeshro/inq 
then. 

If  w is  a 7 era , the  additive  write  flao  in  the  control 
node  is  turned  off. 

''lormal  return  is  zero. 


DIAGMU3TIC3; 

Returned  ~1  indicates  th“  oassed  integer  w is  neoative 
or  greater  tnan  one. 
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